Downloads and reference
Author operations
Find tasks across MCP, REST, and jotcli.
Before you start
A Jot account and a connected interface for account operations.
This page lists Jot actions across MCP, REST, and jotcli. The first table shows shared product operations. The second table shows special routes, output modes, and account actions.
Use an MCP operation
Use publish_note to create a managed note. It accepts the title, Markdown body, collection, and tags as separate inputs. Use upload_media when the MCP client supplies a file.
Call run_operation for an operation in the catalog. Pass the MCP identifier and its arguments. For example, this request lists your notes:
{"operation":"notes.list","arguments":{}}Call get_operation to see the required arguments and response fields. See the MCP manual for authentication and more examples. Use the OpenAPI schema for REST request and response fields.
Operation list
Scroll the table right to see REST and jotcli.
| Task | MCP | REST | jotcli |
|---|---|---|---|
| Publish a temporary note. | pub.create | POST /api/pub | jotcli pub FILE |
| List managed notes. | notes.list | GET /api/notes | jotcli note list |
| Read one managed note. | notes.get | GET /api/notes/id/{note_id} | jotcli note get ID --json |
| Create a note. | publish_notenotes.create | POST /api/notes | jotcli note publish FILE |
| Change a note. | notes.update | PUT /api/notes/{slug} | jotcli note update SLUG --data FILE |
| Move a note to Trash. | notes.delete | DELETE /api/notes/{slug} | jotcli note delete SLUG |
| Change selected notes. | notes.bulk | POST /api/notes/bulk | jotcli note bulk |
| Render a note preview. | notes.preview | POST /api/notes/preview | jotcli note preview FILE |
| List the tags in use. | tags.list | GET /api/tags | jotcli tag list |
| List note revisions. | revisions.list | GET /api/notes/id/{note_id}/revisions | jotcli note revisions ID |
| Compare a revision. | revisions.compare | GET /api/notes/id/{note_id}/revisions/{number}/compare | jotcli note compare ID NUMBER |
| Restore a revision. | revisions.restore | POST /api/notes/id/{note_id}/revisions/{number}/restore | jotcli note restore ID NUMBER |
| List removed notes. | trash.list | GET /api/trash | jotcli trash list |
| Restore a removed note as a draft. | trash.restore | POST /api/trash/{note_id}/restore | jotcli trash restore ID |
| Permanently delete a removed note. | trash.delete | DELETE /api/trash/{note_id} | jotcli trash delete ID |
| List URL redirects. | redirects.list | GET /api/redirects | jotcli redirect list |
| Create a URL redirect. | redirects.create | POST /api/redirects | jotcli redirect add FROM TO |
| Remove a URL redirect. | redirects.delete | DELETE /api/redirects/{redirect_id} | jotcli redirect delete ID |
| List account media. | media.list | GET /api/media | jotcli media list |
| Upload one media file. | upload_mediamedia.upload | POST /api/media | jotcli media upload FILE |
| Delete one media file. | media.delete | DELETE /api/media/{filename} | jotcli media delete NAME |
| Get the complete account ZIP download URL. | export.request | GET /api/export | jotcli export |
| Import public WordPress content. | import.wp | POST /api/import/wp | jotcli import wp --source URL |
| Read account and private-site settings. | site.get | GET /api/me | jotcli site get |
| Change account and private-site settings. | site.update | PATCH /api/profile | jotcli site update --data FILE |
| List available site themes. | site.themes | GET /api/themes | jotcli site themes |
| List invited private-site readers. | readers.list | GET /api/site-invitees | jotcli reader list |
| Invite a private-site reader. | readers.add | POST /api/site-invitees | jotcli reader add EMAIL |
| Remove a private-site reader. | readers.remove | DELETE /api/site-invitees/{invitee_id} | jotcli reader remove ID |
| List custom domains. | domains.list | GET /api/domains | jotcli domain list |
| Add a custom domain. | domains.add | POST /api/domains | jotcli domain add DOMAIN |
| Verify a custom domain. | domains.verify | POST /api/domains/{domain_id}/verify | jotcli domain verify ID |
| Remove a custom domain. | domains.remove | DELETE /api/domains/{domain_id} | jotcli domain remove ID |
Browser and client actions
A dash means the interface does not offer that action. Use the MCP manual, REST manual, or CLI manual for setup, request fields, and command options.
Scroll the table right to see REST and jotcli.
| Task | MCP | REST | jotcli |
|---|---|---|---|
| Claim a temporary note from its browser. | — | POST /api/notes/{slug}/claim | — |
| Publish a saved draft. | notes.update | POST /api/notes/{slug}/publish | jotcli note republish ID |
| Unpublish a note. | notes.update | PUT /api/notes/{slug} | jotcli note unpublish SLUG_OR_UUID |
| Change note tags. | notes.update | PUT /api/notes/{slug} | jotcli tag add ID TAGjotcli tag remove ID TAGjotcli tag set ID TAG |
| Print a note with YAML frontmatter. | — | — | jotcli note get ID --markdown |
| Filter a local note list. | — | — | jotcli note list --select FILTER |
| List, create, or revoke API keys. | — | GET /api/keysPOST /api/keysDELETE /api/keys/{key_id} | — |
| List or revoke connected applications. | — | GET /api/oauth/connectionsDELETE /api/oauth/connections/{grant_id} | — |
| Check or accept terms. | — | GET /api/terms/statusPOST /api/terms/accept | — |
| Sign in with an email code. | — | POST /auth/request-otpPOST /auth/verify-otp | — |
| Check the signed-in account. | — | GET /auth/me | — |
| Save, check, or remove a local key. | — | — | jotcli auth loginjotcli auth statusjotcli auth logout |
| Read the installed CLI version. | — | — | jotcli version |
| Check for or install a CLI update. | — | — | jotcli update --checkjotcli update |
| Read the server version. | — | GET /api/version | — |