MCP tools reference
Inputs, behavior, safety annotations, and limits for all ten Gryz MCP document and Notes tools.
Updated · Reviewed by Jacob
What tools does Gryz provide?
Gryz registers ten MCP tools for authenticated accounts: five document tools and five private Notes tools. The connection needs the documents scope; without it, Gryz exposes none of these tools.
Document tools
| Tool | Required inputs | Optional inputs | Result and important behavior |
|---|---|---|---|
publish_document | content, content_type, visibility | title, slug, expires_in_hours | Creates a separate document and returns its URL/slug. Supports Markdown, HTML, SVG, CSV, Mermaid, and JSON. MCP visibility is public or restricted. |
get_document | slug | — | Returns owned document content and metadata. |
list_documents | — | limit (1–50, default 20), offset | Returns owned documents newest first. |
update_document | slug | content, content_type, title | Replaces supplied fields. At least one update is required; visibility and expiry are not changed by this tool. |
delete_document | slug | — | Permanently deletes the owned document; it cannot be restored. |
Document publishes and updates use the same size, format, private-quota, custom-slug, validation, and moderation rules as the web publishing path. See publishing options and document types.
Notes tools
| Tool | Required inputs | Optional inputs | Result and important behavior |
|---|---|---|---|
list_notes | — | limit (1–50, default 20), offset, q, source | Returns IDs, titles, previews, origin, access mode, and update times. Search is case-insensitive. |
create_note | content | title | Creates a new private Markdown Note, subject to the plan quota. |
update_note | id | content, title | Replaces supplied fields; at least one is required. Fails when the Note is read-only for AI. |
append_note | id, content | — | Adds content with a separating newline when needed. Fails when read-only for AI. |
delete_note | id | — | Soft-deletes the Note. Fails when read-only for AI. |
Note IDs are UUIDs. Use list_notes to find the correct ID before modifying a Note. The source filter accepts me for web-authored Notes, agent for any client-authored Note, or an exact client name. Read the Notes overview before automating a Notes workflow.
Safety annotations
get_document,list_documents, andlist_notesare read-only and idempotent.publish_documentandcreate_noteare additive and non-idempotent: repeating them creates another item.- Updates and deletes are destructive because they replace or remove state.
- Document mutations are open-world because they can affect a publicly reachable link. Notes mutations are closed-world because Notes remain private to the account.
Hourly limits by plan
Limits apply independently to each tool in a rolling one-hour window.
| Tool group | Starter | Pro | Pro Plus |
|---|---|---|---|
| Publish document | 10 | 20 | 60 |
| Get/list documents | 60 | 60 | 120 |
| Update/delete document | 20 | 60 | 120 |
| List Notes | 120 | 240 | 480 |
| Create Note | 20 | 120 | 240 |
| Update/append Note | 40 | 180 | 360 |
| Delete Note | 20 | 60 | 120 |
Rate-limit errors identify the tool limit and retry window. Ownership failures and invalid IDs do not reveal another user's content.
Continue with MCP setup, or use the Documents API for direct HTTP integration.