Skip to content
sensefold Docs

Connect any MCP client

Sensefold is a standard remote MCP server. If your client is not on the Connect your AI list, this page has what it needs.

The endpoint

Section titled “The endpoint”
https://api.sensefold.app/mcp
  • Transport: Streamable HTTP, stateless — no session to maintain.
  • Auth: OAuth 2.1 with PKCE, or Authorization: Bearer <agent key>.

Option A — OAuth (clients that can open a browser)

Section titled “Option A — OAuth (clients that can open a browser)”

Paste the endpoint into the client’s “add remote MCP server” flow. An unauthenticated request receives a 401 carrying the OAuth discovery metadata, so a client that supports OAuth 2.1 finds the authorization server, registers itself, and sends you to the Sensefold consent page. Sign in, pick a tier (read-only by default), approve. No key to copy.

If the client finishes on a 127.0.0.1 callback page that does not load, see Troubleshooting.

Option B — Agent key (clients that send headers)

Section titled “Option B — Agent key (clients that send headers)”
  1. Create a key at app.sensefold.app → Settings → For agents and pick a tier: read_only, edit, or full. The key is shown once.
  2. Configure the client with the URL above and the header Authorization: Bearer <agent key>. Most clients take a JSON block in the shape of the Cursor or VS Code examples.

Keys are environment-bound (lexi_agent_v1_production_…) and revocable in Settings.

Self-check with MCP Inspector

Section titled “Self-check with MCP Inspector”
Terminal window
npx @modelcontextprotocol/inspector \
  --transport http \
  --server-url https://api.sensefold.app/mcp \
  --header "Authorization: Bearer <agent key>"

Inspector shows tools/list with annotations and output schemas and lets you call each tool. Expect 6 tools for a read-only key, 10 for edit, 11 for full — anything else means the wrong key or tier.

What to expect from the tools

Section titled “What to expect from the tools”
  • Reads carry readOnlyHint: true, so well-behaved hosts do not prompt for every search.
  • search and fetch are aliases of the search and read tools, kept for ChatGPT-style connectors.
  • get_item serves long content in windows (8,000 characters by default, windowLength up to 20,000): follow truncated + nextStart.
  • Writes need a client-generated UUID (save_link, save_note) or an expectedVersion from a fresh read (update_note, update_tags, delete_item); on VERSION_CONFLICT, re-read and retry once.
  • Every write is versioned and revertible in Sensefold.

The full contract is in the MCP tools reference; an agent-readable version lives at /for-agents/skill.md.