Install

Plug Tomesphere into your client.

Pick the client you use, add the server URL, and go. Anonymous works at 50 queries / day with no signup. Sign in, and your client walks you through it (OAuth), no key to paste, for 500 / day.

Two terracotta ceramic puzzle pieces interlocking
00 · Claude Desktop · Custom Connector

Add it as a connector.

  1. Open Settings → Connectors.
  2. Click Add → Add custom connector.
  3. Name it Tomesphere MCP and paste this URL:
https://mcp.tomesphere.com/api/mcp

Click Addand you’re done. It works right away, anonymously (50/day). Want more? Sign in through your browser (OAuth, no key to paste) for 500/day.

Need Claude Desktop first? Get it from claude.ai/download.

01 · Claude Code

One command in your terminal

claude mcp add tomesphere --transport http https://mcp.tomesphere.com/api/mcp

That’s it, no key. Start using it right away (50/day). For 500/day, run /mcp and sign in when prompted (a browser opens; approve once).

02 · Cursor

One-click install

Install in Cursor →

Works anonymously right away. For 500/day, Cursor opens a browser to sign in the first time you hit the free limit, no key to paste.

03 · VS Code

GitHub Copilot agent mode

No key needed. VS Code uses anonymous mode, then runs the sign-in flow (OAuth) in your browser when you want the higher limit.

04 · Windsurf

Cascade MCP marketplace

Open Cascade, MCP Marketplace, Add custom server, paste:

{
  "name": "tomesphere",
  "url": "https://mcp.tomesphere.com/api/mcp"
}

No key. Windsurf signs you in through the browser when you cross the free limit.

05 · ChatGPT

Developer mode, Plus or Pro

  1. Settings → Apps & Connectors → Advanced → enable Developer Mode
  2. Add app, type: remote MCP server
  3. URL https://mcp.tomesphere.com/api/mcp
  4. Authentication: None for 50/day, or OAuth and sign in for 500/day. No key to paste either way.

ChatGPT Free doesn't support MCP. Plus or Pro is required.

06 · Zed

HTTP via mcp-remote bridge

Zed is stdio-only. Wrap the HTTP endpoint with the official bridge:

{
  "context_servers": {
    "tomesphere": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.tomesphere.com/api/mcp"]
    }
  }
}

No key. mcp-remote opens a browser to sign in (OAuth) when you want 500/day; until then it’s anonymous.

07 · Other

Generic Streamable HTTP

{
  "name": "tomesphere",
  "transport": "streamable-http",
  "url": "https://mcp.tomesphere.com/api/mcp"
}

Any spec-compliant client discovers our OAuth server from the 401 + WWW-Authenticate response once you pass the free tier, nothing to configure.