PointCast agent kit · open doors, clean receipts

Give your AI
a door into town.

PointCast already publishes the good stuff twice: a page for people and a clean route for machines. Start with one prompt. Add the MCP connector when you want tools. Bring Firecrawl when the open web gets messy.

Works in ChatGPT, Claude, Codex, and most web-enabled assistants

Start with one sentence.

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.
Open the agent kit →

02 · Pick your door

Four clients. The same town.

Read-only exploration first. Tools that tap, post, claim, or participate stay human-approved.

01 / 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.

02 / 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.

03 / 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.

04 / 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.

03 · The open-source web scraper

It’s Firecrawl.

Open-source web context layer for pages that do not already publish a clean machine surface. For PointCast, native JSON and MCP stay first; Firecrawl is the flexible reader for rendered pages and outside sources.

Core: AGPL-3.0. MCP server: MIT.

Install CLI + agent skills

npx -y firecrawl-cli@latest init --all --browser

Smoke-test PointCast — keyless

firecrawl scrape https://pointcast.xyz/llms.txt --format markdown --only-main-content

04 · Don’t scrape a clean door

PointCast retrieval order

  1. Orient/agent-kit.md · /agents.json · /llms.txt
  2. Read evidencethe adjacent .json twin or /b/{id}.json
  3. Search and navigate/api/mcp-v2 · /blocks.json · /feed.json
  4. Crawl lastrendered pages or outside sites with Firecrawl

Priority link

PointCast v2

live · town · priority 0

PointCast v2

Fresh PointCast MCP connector for AI clients: same town-wide tools, Nouns Nation Battler wiki briefs, agent tasks, result tracking, watch-frame handoffs, new URL, distinct server identity, and Claude-friendly annotations.

Open discovery

ChatGPT

Read https://pointcast.xyz/agent-kit.md in a web-enabled chat.

ChatGPT Work uses plugin-provided MCP tools; the public prompt route needs no install.

Codex / ChatGPT desktop

codex mcp add pointcast-v2 --url https://pointcast.xyz/api/mcp-v2

Or add a Streamable HTTP server from Settings → MCP servers.

Claude / Claude Desktop

Settings → Connectors → Add custom connector.

Use “PointCast v2” as the name and paste the endpoint URL. Plan and workspace policy may apply.

Claude Code

claude mcp add --transport http pointcast-v2 https://pointcast.xyz/api/mcp-v2

Best for testing the fresh connector identity before replacing v1.

Cursor

Add the URL under mcpServers.pointcastV2.url.

Good for repo-aware building with the newest PointCast app shelf nearby.

Client-visible tools

  • connector_links
  • apps_list
  • nouns_battler_wiki
  • nouns_battler_agent_tasks
  • nouns_battler_manifest
  • nouns_battler_result_tracker
  • nouns_battler_cowork_brief
  • town_map
  • surfaces_list

live · town · priority 1

PointCast

The whole PointCast town as an MCP connector: blocks, rooms, presence, apps, Nouns Nation Battler wiki briefs, tasks, result tracking, watch-frame handoffs, contracts, weather, channels, and the drum hub.

Open discovery

ChatGPT

Read https://pointcast.xyz/agent-kit.md in a web-enabled chat.

ChatGPT Work uses plugin-provided MCP tools; the public prompt route needs no install.

Codex / ChatGPT desktop

codex mcp add pointcast --url https://pointcast.xyz/api/mcp

Or add a Streamable HTTP server from Settings → MCP servers.

Claude / Claude Desktop

Settings → Connectors → Add custom connector.

Use “PointCast” as the name and paste the endpoint URL. Plan and workspace policy may apply.

Claude Code

claude mcp add --transport http pointcast https://pointcast.xyz/api/mcp

Best for local agent work and task handoffs.

Cursor

Add the URL under mcpServers.pointcast.url.

Good for repo-aware building with PointCast context nearby.

Client-visible tools

  • town_map
  • surfaces_list
  • connector_links
  • apps_list
  • nouns_battler_wiki
  • nouns_battler_agent_tasks
  • nouns_battler_manifest
  • nouns_battler_result_tracker
  • nouns_battler_cowork_brief