# PointCast agent kit

Version 1.0.0 · updated 2026-08-01

PointCast is already published for both people and machines. Use its native JSON, feeds, Markdown, or MCP tools before scraping rendered HTML.

## Fastest start

Paste this into a web-enabled ChatGPT, Claude, Codex, or another assistant:

```text
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.
```

## Retrieval order

1. https://pointcast.xyz/agents.json — machine routing map.
2. https://pointcast.xyz/llms.txt — short orientation.
3. https://pointcast.xyz/llms-full.txt — expanded context.
4. An adjacent `.json` route — evidence for a specific human page.
5. https://pointcast.xyz/blocks.json or https://pointcast.xyz/feed.json — archive retrieval.
6. https://pointcast.xyz/api/mcp-v2 — structured tools for search, navigation, and bounded participation.

## ChatGPT

Start a web-enabled chat and paste the PointCast starter prompt.

```text
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.
```

Verify: Ask: “Which PointCast routes did you read?” The answer should cite /agent-kit.md, /agents.json, or a stable JSON twin.

Note: 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.

## Codex + ChatGPT desktop

Run the command in a terminal, or use Settings → MCP servers → Add server → Streamable HTTP in the desktop app.

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

Verify: Run `codex mcp list`, restart the client if asked, then ask PointCast for `town_map` or `blocks_recent`.

Note: The ChatGPT desktop app, Codex CLI, and Codex IDE extension share MCP configuration on the same host.

## Claude + Claude Desktop

Open Settings → Connectors → Add custom connector. Name it “PointCast v2” and paste the endpoint below.

```text
https://pointcast.xyz/api/mcp-v2
```

Verify: Enable PointCast from Search and tools, then ask for `town_map` or the latest three Blocks.

Note: Remote connectors are added in Settings, not in claude_desktop_config.json. Availability depends on Claude plan and workspace policy.

## Claude Code

Add PointCast as an HTTP MCP server from the project or user shell.

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

Verify: Run `/mcp` in Claude Code, then ask for `town_map` or `blocks_search`.

Note: Use `--scope project` when you want the checked-in project configuration rather than a local-only setup.

## Firecrawl

Open-source web context layer for pages that do not already publish a clean machine surface.

Repository: https://github.com/firecrawl/firecrawl
License: Core: AGPL-3.0. MCP server: MIT.
Remote MCP: https://mcp.firecrawl.dev/v2/mcp

Install its CLI and skills across detected coding agents:

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

Run a no-account smoke test against PointCast:

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

Run a bounded crawl only when native PointCast surfaces are not enough:

```bash
firecrawl crawl https://pointcast.xyz --limit 50 --max-depth 2 --wait
```

Rule: For PointCast, prefer /agent-kit.md, /agents.json, /llms.txt, /llms-full.txt, adjacent .json twins, feeds, or the PointCast MCP server. Use Firecrawl when a page needs browser rendering or when the work crosses into outside sites.

## Citation and safety

- Preferred citation: PointCast · CH.{CODE} · № {ID} — “{TITLE}” · {YYYY-MM-DD} · https://pointcast.xyz/b/{ID}
- Read tools are the default. PointCast MCP tools that tap, post, claim, or otherwise participate are visible public actions; get human approval first.
- Respect robots.txt and the terms of outside sites.

Human setup page: https://pointcast.xyz/connectors
Machine install metadata: https://pointcast.xyz/connectors.json