13 tools available to any MCP-compatible AI agent. Each tool is a JSON-RPC method call to POST /api/mcp/
List all notes in the notebook. Returns titles, IDs, word counts, tags, and last modified dates.
Parameters:
None
Returns:
Array of note summaries (id, title, wordCount, tags, lastModified)
Use case:
"Show me all my notes" / "What's in my notebook?"
Create a new note in the notebook. Agent-created notes are tagged agent-created automatically.
Parameters:
| title | string, required | Note title |
| content | string, required | Note body (Markdown supported) |
Use case:
"Save this research to my xNotePadAI" / "Create a meeting notes template"
Get the full content of a specific note by ID. Confidential sections are excluded.
Parameters:
| note_id | string, required | The note's unique ID |
Use case:
"Read my Project Alpha note" / "What's in that meeting note?"
Update the content or title of an existing note. Replaces the full content.
Parameters:
| note_id | string, required | Target note ID |
| content | string, required | New content |
| title | string, optional | New title |
Use case:
"Add today's decisions to the project note" / "Append these action items"
Delete a note. Only notes tagged agent-created can be deleted via the API (safety guard).
Parameters:
| note_id | string, required | Note to delete |
Safety:
Human-created notes cannot be deleted by agents — only archived.
Semantic search across all notes using vector embeddings. Finds notes by meaning, not just keywords.
Parameters:
| query | string, required | Natural language search query |
Use case:
"Find notes about machine learning" / "What did I write about the budget?"
Ask a question and get an AI-generated answer synthesised from your notes. Powered by Llama 3.3 70B + RAG.
Parameters:
| question | string, required | Your question in natural language |
Use case:
"What did I decide about the project timeline?" / "Summarise my meeting notes from this week"
Retrieve version history for a specific note. Shows previous content snapshots with timestamps.
Parameters:
| note_id | string, required | Note to get history for |
Use case:
"Show me the previous version of this note" / "What did this note say yesterday?"
Add tags to a note. Tags are merged with existing ones (no duplicates).
Parameters:
| note_id | string, required | Target note |
| tags | array, required | Tags to add (e.g. ["work", "urgent"]) |
Use case:
"Tag my meeting notes with 'work' and 'Q3'" / "Organise these notes by topic"
Create a [[wiki-link]] from a source note to a target note. Appends the link to the source note's content.
Parameters:
| source_id | string, required | Note to add the link in |
| target_title | string, required | Title of the note to link to |
Use case:
"Connect my project plan to the meeting notes" / "Link related research notes"
Merge source note into target. Source content is appended to target, then source is deleted.
Parameters:
| source_id | string, required | Note to merge from (will be deleted) |
| target_id | string, required | Note to merge into (receives content) |
Use case:
"Merge these two meeting notes into one" / "Combine duplicate notes"
Archive a note. Hidden from main view but recoverable. Safer than delete for human-created notes.
Parameters:
| note_id | string, required | Note to archive |
Use case:
"Archive old meeting notes" / "Clean up my notebook — archive anything older than 30 days"
agent-created notes can be deleted via API