txt / mcp

Connect agents to txt—and txt to your tools

The txt endpoint gives compatible MCP clients scoped access to synchronized notes. The separate Executor endpoint gives the txt agent a user-scoped gateway to external MCP, OpenAPI, GraphQL, and connected-app tools.

canonical endpoint

https://txt.mn/mcp

Authenticated services are standardized on txt.mn: /mcp, /api, and /sync. Existing product-domain MCP URLs remain accepted and discover txt.mn for authorization.

outbound tool gateway

Executor for the txt agent

Vercel Connect connector executor.sh/executor points at https://executor.sh/dots/mcp. OAuth is scoped to the current Linq or Slack user. Use /tools to inspect the authorized catalog and /do request for an approval-governed action; txt files continue through the direct txt connection.

vercel connect create https://executor.sh/dots/mcp --name executor
vercel connect attach executor.sh/executor --project txt-agent --environment production

Claude

open Claude connectors ↗

Claude and Claude Desktop: Settings → Connectors → Add custom connector. Remote servers do not belong in claude_desktop_config.json. Claude Code can add the same endpoint from the terminal.

Claude / Desktop URL: https://txt.mn/mcp

claude mcp add --transport http --scope user txt https://txt.mn/mcp
# then open Claude Code and run /mcp to authenticate

Codex

OpenAI documentation ↗

Add the Streamable HTTP server, then complete OAuth + PKCE in the system browser when Codex asks.

codex mcp add txt --url https://txt.mn/mcp --oauth-client-registration dcr
codex mcp login txt --oauth-client-registration dcr

Cursor

Cursor MCP guide ↗

Add this remote URL globally or per project. Cursor discovers OAuth automatically; its CLI shares the same configuration.

{
  "mcpServers": {
    "txt": { "url": "https://txt.mn/mcp" }
  }
}
# optional Cursor CLI verification: agent mcp login txt

Grok

open Grok connectors ↗

Create one Custom connector and enter the public txt MCP URL. Grok should open OAuth before its first protected tool call.

Connector name: txt
MCP server URL: https://txt.mn/mcp
Authentication: OAuth

Know when it is actually connected

1. added
The client saved the endpoint and discovered public tool schemas. Private access is not proven yet.
2. authorized
You approved the requested scopes and the client received a bearer token.
3. verified
Ask the client to run list-files. A successful result confirms the token reaches txt.

A green Added state alone means configuration succeeded. If the client shows Retry, remove the duplicate connector, add only https://txt.mn/mcp, complete OAuth, and verify with list-files.

WebMCP + remote MCP

All 44 txt tools

The signed-in N0T.ES editor registers these same tools with browsers that support WebMCP. Remote clients discover them from https://txt.mn/mcp. Both surfaces use the same authenticated handlers and schemas.

create-listwrite

Create a portable list of links, notes, files, nested lists, or custom records.

inputs: title, items or text, requestId

create-listswrite

Create up to 50 lists atomically in one request.

inputs: lists, requestId

get-listread

Read ordered items, stable IDs, revision, and fork source.

inputs: id

list-listsread

Search and page through list metadata without fetching item bodies.

inputs: q, cursor, limit

edit-listwrite

Bulk add, update, remove, move, reorder, or deduplicate items in one revision.

inputs: id, revision, requestId, operations, title, description

fork-listwrite

Create an independent private copy of a list or selected items.

inputs: id, revision, requestId, title, itemIds

connect-fileswrite

Connect two files in the workspace brain and optionally accept a pending suggestion.

inputs: sourceFileId, targetFileId, reason, suggestionId

create-agent-checkoutagent action

Create a secure subscription checkout link for the authenticated phone-agent credential.

inputs: none

create-diagramwrite

Create a validated Mermaid diagram note.

inputs: name, source, folderId

create-filewrite

Create a workspace file and return its new file ID.

inputs: name, content, context, tags, fileType, folderId, availability

create-folderwrite

Create or reuse a workspace folder.

inputs: name, parentId, reuseExisting

create-publicationwrite

Turn an existing folder into a private publication for dots.id subscribers.

inputs: folderId, title, description

derive-publication-notewrite

Save a snapshot or fork an editable published note into the Notes Brain.

inputs: issueId, kind

file-inforead

Inspect storage metadata, content type, byte size, and the private download endpoint without reading the body.

inputs: id

get-accountread

Check the connected dots.id account, phone-agent subscription, workspace access, and available functions.

inputs: none

get-clueread

Read brain clusters, suggestions, unresolved wikilinks, profile, and optional semantic neighbors.

inputs: fileId (optional)

get-fileread

Read the complete content of one file by its ID.

inputs: id

get-publicationread

Preview or read an authorized publication and its published notes.

inputs: slug

grow-ideation-noteAI action

Expand an owned note using its full contents and workspace-brain context.

inputs: id, seed

import-filewrite

Import a public HTTPS attachment into the user’s private dots storage.

inputs: url, name, folderId, context, tags

ingest-imagewrite

Preserve an image, create or append its Markdown or Mermaid representation, and connect both workspace files.

inputs: url, originalName, outputType, content, noteName, targetFileId, folderId, context, tags

inspect-skillread

Read a skills.sh package snapshot and its security audits without installing its untrusted contents.

inputs: id, agent

install-skillwrite

Install an audited package into the private .skills workspace; high-risk or failed audits remain blocked.

inputs: id, agent, folderId, files

list-filesread

List workspace folders and files with IDs, types, sizes, timestamps, and endpoint paths.

inputs: none

list-fx-modelsread

List the allowlisted models available for FX artifact iteration and identify the default.

inputs: includeIds

list-identitiesread

List connected dots.id users and identify the active user for this credential.

inputs: none

list-publication-subscriptionsread

List publication subscriptions for the active dots.id identity.

inputs: none

list-publicationsread

List owned folder publications with reader and published-note counts.

inputs: none

list-skillsread

List published agent skills, including collaborator-shared skills and their catalog paths.

inputs: none

publish-filewrite

Publish the current immutable revision of a note in a publication folder.

inputs: publicationId, fileId

purge_trashed_notepermanent

Permanently delete an eligible trashed note using the exact confirmation phrase.

inputs: id, confirmation

render-artifactwrite

Render a source note into a validated static artifact and deployment handoff.

inputs: fileId, format, design

resolve-fileread / optional write

Resolve an owned workspace path to a file ID. Creating missing folders or an empty note requires file write access and defaults to off.

inputs: path, createIfMissing

restore_notewrite

Restore a trashed note to the normal workspace.

inputs: id

run_aclueAI action

Re-reason over the workspace, updating brain state and possibly creating unreviewed drafts.

inputs: confirmation

search-skillsread

Search private txt skills and the federated skills.sh catalog as untrusted discovery metadata.

inputs: query, owner, view, limit

set-publication-subscriptionwrite

Subscribe or unsubscribe the signed-in dots.id user from a publication.

inputs: slug, active

share-filewrite

Create a short-lived external download link for a dots-backed file.

inputs: id, expiresIn

shorten-dropbox-linkwrite

Create a short txt preview or gallery link from a public Dropbox share URL.

inputs: url

start-agent-onboardingagent action

Complete phone-agent onboarding or return the required secure checkout link.

inputs: none

switch-identitywrite

Switch the active dots.id user for only this MCP or phone connection.

inputs: target

trash_notewrite

Move a note to reversible trash for the retention period.

inputs: id

update-filewrite

Change a file’s content, name, context, tags, or local-mirror availability.

inputs: id + content, name, context, tags, or availability

view-skillwrite

Save an inert private package snapshot under .viewed-skills for review without installing it.

inputs: id

The endpoint uses Streamable HTTP and standard JSON-RPC initialization. OAuth clients discover txt’s public authorization server, register with DCR, use PKCE S256, and request scoped access. Clients without OAuth can use a scoped txt_… key from /sync.

Start with list-files or list-skills. Use trash_note for ordinary removal; permanent purge applies only to an already-trashed note and requires exact confirmation.

generic MCP configuration

{
  "mcpServers": {
    "txt": {
      "url": "https://txt.mn/mcp"
    }
  }
}