{
  "markdown": "# TalkToPlanB MCP Server\n\nLet AI assistants (Claude Desktop, and any [Model Context Protocol](https://modelcontextprotocol.io) client) use **[TalkToPlanB](https://talktoplanb.duckdns.org/)** — list chat rooms, read messages, and send messages.\n\nIt wraps the TalkToPlanB developer REST API and talks MCP over **stdio**.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `whoami` | Account info for the current API key (user id, username, scopes). |\n| `list_rooms` | List your group chats and direct messages (returns room ids). |\n| `read_messages` | Read recent messages in a room (`roomId`, optional `limit`). |\n| `send_message` | Send a message by `roomId` **or** `toPhone` (plus `text`). |\n\n## 1. Get an API key\n\n1. Open the developer portal: <https://talktoplanb.duckdns.org/portal>\n2. Register / log in, create a key, and grant the `messages:read` and `messages:send` scopes.\n3. Copy the key (looks like `ttpb_xxxxxxxx...`).\n\n## 2. Use it with Claude Desktop\n\nAdd this to your Claude Desktop config\n(`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows,\n`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"talktoplanb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"talktoplanb-mcp\"],\n      \"env\": {\n        \"TALKTOPLANB_API_KEY\": \"ttpb_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop, then try: *“List my TalkToPlanB rooms”* or\n*“Send a TalkToPlanB message to +60123456789 saying hello.”*\n\n### Environment variables\n\n| Variable | Required | Default |\n|---|---|---|\n| `TALKTOPLANB_API_KEY` | ✅ | — |\n| `TALKTOPLANB_BASE_URL` | ❌ | `https://talktoplanb.duckdns.org` |\n\n## 3. Local development\n\n```bash\ncd mcp-server\nnpm install\nnpm run build      # compiles src → dist\nTALKTOPLANB_API_KEY=ttpb_... npm start\n```\n\n## 4. Publish to npm (so `npx talktoplanb-mcp` works for everyone)\n\n```bash\ncd mcp-server\nnpm login\nnpm publish --access public\n```\n\nAfter publishing, you can list it on MCP registries (mcp.so, Glama, Smithery) —\nsee `../marketing/listing-checklist.md`.\n\n## Notes\n\n- Requires Node.js 18+ (uses the built-in `fetch`).\n- `stdout` carries the MCP protocol; all logs go to `stderr`.\n- The server only does what your API key is allowed to do (its scopes).\n",
  "bytes": 2243,
  "sha": "6b24ba01a38d96e65a4ce79f92e45b68d270ed0760fc3dfa50e4a4a26d6696b7",
  "repo_slug": "jmlee850623/talktoplanb-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jmlee850623_talktoplanb_mcp_f99cf865/readme"
}