Context for AI agents (via MCP)

ctxt.io is a hosted Model Context Protocol server.

Connect it to Claude Code, Codex, Cursor, VS Code, or any MCP client, and your AI agent can turn diffs, logs, snippets, and docs into auto-expiring share links — and read them back. No account, no API key, nothing to install.

Set up in your client

The server lives at https://ctxt.io/mcp (remote, Streamable HTTP).

Claude Code

claude mcp add --transport http ctxt https://ctxt.io/mcp

Or check a project-scoped config into your repo so your whole team gets it — add this to .mcp.json:

{
  "mcpServers": {
    "ctxt": { "type": "http", "url": "https://ctxt.io/mcp" }
  }
}

Codex

codex mcp add ctxt --url https://ctxt.io/mcp

Or add to ~/.codex/config.toml:

[mcp_servers.ctxt]
url = "https://ctxt.io/mcp"

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector → enter https://ctxt.io/mcp.

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "ctxt": { "url": "https://ctxt.io/mcp" }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "ctxt": { "type": "http", "url": "https://ctxt.io/mcp" }
  }
}

Anything else

Point any MCP client at https://ctxt.io/mcp. The server is stateless Streamable HTTP: plain JSON responses, no SSE stream, no session ids, no authentication.

Free vs Pro

	Free	Pro ($1 per link)
Expiry	5m, 30m, 1h, 8h, or 1d	30 days
Custom name in URL	—	✓
Password protection	—	✓

Free links are created instantly. When your agent requests ttl=30d, the link is created in a pending state and the tool result includes a payment_url — open it in a browser and complete the $1 checkout to activate the 30 days (and the name/password options). Until payment, the link lives 1 day.

The tools

create_context

Share content as an expiring link.

• content (required) — the text to share, up to 4MB.
• ttl — 5m, 30m, 1h (default), 8h, 1d, or 30d.
• format — text (default, verbatim), markdown (rendered), code (syntax highlighted; optional lang), or html (sanitized).
• name, password — Pro options, honored with ttl=30d.

Returns the share URL, its .md/.txt/.json variants, the expiry time, and a delete_token that authorizes later deletion — treat the token as a secret.

read_context

Fetch an existing ctxt.io link as markdown (default), plain text, or HTML. Takes the full URL, the /3/<code> path, or the bare code, plus password for protected links.

delete_context

Delete a link you created, using its delete_token. Immediately removes public access and requests backing-storage deletion. Destructive — agents should confirm with you before calling it.

Reading pastes without MCP

Every paste URL has robot-readable twins: append .md, .txt, or .json. The .json twin returns the content plus ttl, created, and expires_at:

curl https://ctxt.io/3/YOURKEY.json

MCP is the supported way for machines to create pastes — it carries the rate limits and abuse protections that keep the service free.

Limits and security

• Links are bearer-accessible: anyone who has the URL can read it until it expires.
• Content is stored in plain form at rest. Password protection is an access gate, not encryption.
• Passwords and delete tokens pass through your agent's transcript — don't reuse a password that matters.
• Content is capped at 4MB per link; creation is rate-limited per IP; shared links are excluded from search engines.

Discovering this server

The server is published in the official MCP registry as io.ctxt/mcp. Questions or ideas: feedback@ctxt.io.