Skip to main content
← Back to Unimatrix

MCP Quickstart

Create an MCP token in Settings → MCP Tokens, then point a supported client at the hosted endpoint.

Cursor, Windsurf, VS Code, and other HTTP clients

{
  "mcpServers": {
    "unimatrix": {
      "type": "streamable-http",
      "url": "https://www.deployunimatrix.com/api/mcp",
      "headers": {
        "Authorization": "Bearer umx_YOUR_MCP_TOKEN"
      }
    }
  }
}
  1. 1

    Create an MCP token

    Create an account, then open Settings → MCP Tokens. The free plan includes one token. The secret is shown once. Revoke it before creating another.

    /api/mcp accepts an api_keys credential and an mcp_tokens credential. Both start with umx_.

  2. 2

    Connect the client

    Claude Desktop

    Claude Code, and Claude Desktop custom connectors, use the remote Streamable HTTP server.

    claude mcp add --transport http unimatrix https://www.deployunimatrix.com/api/mcp --header "Authorization: Bearer umx_YOUR_MCP_TOKEN"

    A stdio-only Claude Desktop build uses mcp-remote. The published header form is --header "Authorization: Bearer ${UMX_TOKEN}".

    {
      "mcpServers": {
        "unimatrix": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://www.deployunimatrix.com/api/mcp", "--header", "Authorization: Bearer ${UMX_TOKEN}"],
          "env": { "UMX_TOKEN": "umx_YOUR_MCP_TOKEN" }
        }
      }
    }

    Web chats

    ChatGPT, Gemini, and Grok in a browser do not connect through a published Unimatrix extension. A desktop proxy exists as source and is not a released installer. Use an MCP or REST client, or the VS Code package on the downloads page.

    See what is on the downloads page →

    Custom agents and REST

    Base https://www.deployunimatrix.com/api. Auth Authorization: Bearer umx_YOUR_MCP_TOKEN. Schemas are in the MCP reference.

  3. 3

    Ask it to recall

    In a new conversation, ask the client to call unimatrix_recall or to list your spaces. The model has to invoke the tool. A connected client does not load memory on its own.

Next steps

Clients that can connect

These guides match a client that can call the hosted MCP endpoint or the provider gateway.