Documentation

How to connect any AI client to UseMyContext over MCP, what the thirteen tools do, folder mapping with .umc, the security model, and plans and limits.

What UseMyContext.ai is

UseMyContext.ai is a personal context layer: one profile of who you are and what you are working on, kept in your own account, that any AI client can read over MCP (the Model Context Protocol). You write and approve your UseMyContext profile once; every connected MCP client starts each conversation already knowing it.

The whole service is one remote MCP server over Streamable HTTP (the transport also described as Server-Sent Events, or SSE, and HTTP POST):

https://mcp.usemycontext.ai/mcp

Using Claude on the web or Claude Desktop? The quickest connect is one click from the Claude Connectors Directory - our Community-tier listing. Open the listing, click Connect, and approve the OAuth screen. No URL to paste.

Any MCP client that speaks Streamable HTTP can use this universal configuration (also the manual path for Claude). Authentication is browser-based OAuth 2.1 with PKCE, so there is no API key to paste:

{
  "mcpServers": {
    "usemycontext": {
      "type": "http",
      "url": "https://mcp.usemycontext.ai/mcp"
    }
  }
}

Claude Desktop reads the same block from its config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Building with AI? Read the raw-text documentation directly at /llms.txt (the index) or /llms-full.txt (the full corpus), served as clean Markdown for retrieval pipelines, following the llms.txt standard.

Client compatibility and transport

Every client below reaches the same remote MCP server over Streamable HTTP, the same account, and the same profile. Most sign in over OAuth 2.1 with PKCE (no API key); a few use an access token in an Authorization: Bearer header instead.

Client	Category	Auth
Claude (web and desktop)	Chat app	OAuth 2.1 (PKCE)
ChatGPT (Developer Mode, paid plans)	Chat app	OAuth 2.1 (PKCE)
Gemini	Chat app	OAuth 2.1 (PKCE), token-header fallback
Perplexity	Chat app	Custom MCP connectors disabled by Perplexity for now
Claude Code	Coding tool	OAuth 2.1 (PKCE)
Cursor	Coding tool	OAuth 2.1 (PKCE)
VS Code	Coding tool	OAuth 2.1 (PKCE)
Codex CLI	Coding tool	OAuth 2.1 (PKCE), token-header fallback
Cline	Coding tool	Bearer token header
Gemini CLI	Coding tool	OAuth 2.1 (PKCE), token-header fallback
Goose	Coding tool	Bearer token header
Any MCP client	Anything else	OAuth 2.1 (PKCE) or Bearer token header
Apple Shortcuts	Anything else	Bearer token header
Linear	Anything else	Bearer token header

Per-client setup steps are in Connect your client.

The thirteen tools at a glance

A connected AI sees exactly thirteen MCP tools. Twelve are reads (including search and fetch, thin aliases of search_files and get_file added for ChatGPT deep-research compatibility); the single write tool only files a pending suggestion for you to review. Full reference: The thirteen tools.

Tool	What it does	Access	Scope
`profile`	Reads your compiled profile, built only from facts you accepted.	Read	`profile:read`
`list_profiles`	Lists your own profiles (projects) with each one’s name, @handle, and privacy status, and marks which one a connection reads. Metadata only.	Read	`profile:read`
`info`	Explains what UseMyContext is, what a connection can and cannot do, and where to manage your account. Static public information only.	Read	`profile:read`
`account`	Reports your current plan, projects and storage used against your limits, and where to upgrade. Metadata only.	Read	`profile:read`
`list_files`	Lists your uploaded files (names and metadata only).	Read	`files:read`
`search_files`	Finds your documents by filename or metadata.	Read	`files:read`
`search`	The deep-research alias of `search_files` (ChatGPT’s search result shape).	Read	`files:read`
`get_file`	Returns one file’s full extracted text, size-guarded.	Read	`files:read`
`fetch`	The deep-research alias of `get_file` (ChatGPT’s fetch result shape).	Read	`files:read`
`ask_docs`	Answers from your documents with cited passages.	Read	`docs:read`
`query_table`	Runs exact counts, sums, filters, and grouped totals over one tabular file.	Read	`docs:read`
`suggest_update`	Files a pending suggestion for you to review. Pending only: it never edits your data.	Write	`updates:write`
`shared_context`	Reads context others deliberately shared with you.	Read	`shared:read`

Integration guides and common workflows

Create an account and make my first connection: Getting started - the account comes free with your first OAuth approval, and a read-only demo account lets you look around first.
Connect a specific client: Connect your client - exact steps for Claude (web and desktop), Claude Code, Cursor, ChatGPT Developer Mode, and any other MCP client.
See what a connected AI can actually do: The thirteen tools - every tool, what it does, and the scope it requires.
Point a repo at the right profile: Folder mapping (.umc) - bind a folder to one of your projects in Claude Code or Cursor.
Evaluate the security model: Security - OAuth 2.1 with PKCE, per-tool scopes, audited reads, server-enforced revocation, and the structurally blind public surface, written for IT admins.
Understand plans and limits: Plans and limits - what Free and Premium include, and where Teams fits.
Put your public card on a site: Embed - a two-line snippet to embed your public context, plus the signup widget, with no tracking.

Support: how to reach us, and the common set-up guides.
Privacy policy: what UseMyContext holds, what it cannot read, and your rights.
GitHub: plugin sources and per-client configuration examples.
usemycontext on npm: a typed client and React hook for building your own app over MCP.

Documentation

What UseMyContext.ai is

Client compatibility and transport

The thirteen tools at a glance

Integration guides and common workflows

Frequently asked questions

Does UseMyContext require a local API key?

Which transport protocol does UseMyContext use?

Which AI clients can connect to UseMyContext?

Do I need a browser extension to use UseMyContext?

More