Install

Plug Tomesphere into your client.

Pick the client you use, add the server URL, and go. It works at 50 queries / day out of the box; if your client authenticates over OAuth the daily cap is 500. No key to paste, no payment.

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 (50/day). If your client authenticates over OAuth in the browser, the cap is 500/day — no key to paste.

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 approve the OAuth prompt when it appears (a browser opens; approve once).

02 · Cursor

One-click install

Install in Cursor →

Works right away at 50/day. For 500/day, Cursor opens a browser for the OAuth prompt the first time you hit the limit — no key to paste.

03 · VS Code

GitHub Copilot agent mode

Install in VS Code →VS Code Insiders

No key needed. VS Code starts at 50/day, then runs the OAuth prompt in your browser for the higher 500/day cap.

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 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 for the OAuth prompt when you want 500/day; until then it runs at 50/day.

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.

Full tool reference→Email [email protected]→