One-sheet · MCP · 5 clients · 14 tools

How to add an MCP, in one sitting.

An MCP server is a URL your AI client can add as a connector. Once it is added, the client sees a list of named tools it can call for search, navigation, and bounded participation, instead of scraping pages.

Plain text JSON

The worked example

PointCast publishes its own. Every recipe below points at it.

Pick your client

Four recipes as written on /connectors, plus the Cursor line from /connectors.json. The ChatGPT one needs no install: it is the starter prompt from /agent-kit.md.

  • No install · public web ChatGPT Start a web-enabled chat and paste the PointCast starter prompt.
    Read https://pointcast.xyz/agent-kit.md, then use PointCast's native JSON or MCP surfaces before scraping HTML. Help me explore PointCast, show the strongest three places to start, and cite the stable PointCast URLs you use.
    Test it: Ask: “Which PointCast routes did you read?” The answer should cite /agent-kit.md, /agents.json, or a stable JSON twin. ChatGPT web does not read local Codex MCP settings. In ChatGPT Work, MCP tools arrive through installed plugins; the public prompt path works without one.
  • Remote MCP · read first Codex + ChatGPT desktop Run the command in a terminal, or use Settings → MCP servers → Add server → Streamable HTTP in the desktop app.
    codex mcp add pointcast-v2 --url https://pointcast.xyz/api/mcp-v2
    Test it: Run `codex mcp list`, restart the client if asked, then ask PointCast for `town_map` or `blocks_recent`. The ChatGPT desktop app, Codex CLI, and Codex IDE extension share MCP configuration on the same host.
  • Custom connector · paid plans Claude + Claude Desktop Open Settings → Connectors → Add custom connector. Name it “PointCast v2” and paste the endpoint below.
    https://pointcast.xyz/api/mcp-v2
    Test it: Enable PointCast from Search and tools, then ask for `town_map` or the latest three Blocks. Remote connectors are added in Settings, not in claude_desktop_config.json. Availability depends on Claude plan and workspace policy.
  • Remote MCP · one command Claude Code Add PointCast as an HTTP MCP server from the project or user shell.
    claude mcp add --transport http pointcast-v2 https://pointcast.xyz/api/mcp-v2
    Test it: Run `/mcp` in Claude Code, then ask for `town_map` or `blocks_search`. Use `--scope project` when you want the checked-in project configuration rather than a local-only setup.
  • config file · mcpServers Cursor Add the URL under mcpServers.pointcastV2.url.
    {
      "mcpServers": {
        "pointcastV2": {
          "url": "https://pointcast.xyz/api/mcp-v2"
        }
      }
    }
    Good for repo-aware building with the newest PointCast app shelf nearby.

Safety

  • Treat PointCast MCP write-capable tools as visible public actions and require human approval before using them.
  • Read tools are the default. PointCast MCP tools that tap, post, claim, or otherwise participate are visible public actions; get human approval first.
  • Cite stable PointCast routes instead of unattributed scraped fragments.

Other sheets: /send/ai-tools · /send/ai-capital · /send/kennel-club