{
  "markdown": "<!-- mcp-name: io.github.qso-graph/pota-mcp -->\n# pota-mcp\n\nMCP server for [Parks on the Air (POTA)](https://pota.app/) — live activator spots, park info, activator/hunter stats, and scheduled activations through any MCP-compatible AI assistant.\n\nPart of the [qso-graph](https://qso-graph.io/) project. **No authentication required** — all POTA endpoints are public.\n\n## Install\n\n```bash\npip install pota-mcp\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `pota_spots` | Current activator spots with park/grid enrichment and optional filters |\n| `pota_park_info` | Park details by reference code (name, grid, type, agencies, website) |\n| `pota_park_stats` | Activation and QSO counts for a park |\n| `pota_user_stats` | Activator/hunter stats by callsign |\n| `pota_scheduled` | Upcoming scheduled activations |\n| `pota_location_parks` | All parks in a state/province/country |\n| `pota_nearby_parks` | Find parks near a point — great for 2-fer planning |\n| `get_version_info` | Service version + upstream spec version (fleet identity attestation) |\n\n## Quick Start\n\nNo credentials needed — just install and configure your MCP client.\n\n### Configure your MCP client\n\npota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.\n\n#### Claude Desktop\n\nAdd to `claude_desktop_config.json` (`~/Library/Application Support/Claude/` on macOS, `%APPDATA%\\Claude\\` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n#### Claude Code\n\nAdd to `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n#### ChatGPT Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n#### VS Code / GitHub Copilot\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n#### Gemini CLI\n\nAdd to `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project):\n\n```json\n{\n  \"mcpServers\": {\n    \"pota\": {\n      \"command\": \"pota-mcp\"\n    }\n  }\n}\n```\n\n### Ask questions\n\n> \"What POTA activations are happening right now?\"\n\n> \"Tell me about park US-0001 — how many activations has it had?\"\n\n> \"What are K4SWL's POTA stats?\"\n\n> \"Show me all parks in Idaho\"\n\n> \"Are there any CW activators on 20m right now?\"\n\n> \"What activations are scheduled for tomorrow?\"\n\n## Testing Without Network\n\nFor testing all tools without hitting the POTA API:\n\n```bash\nPOTA_MCP_MOCK=1 pota-mcp\n```\n\n## MCP Inspector\n\n```bash\npota-mcp --transport streamable-http --port 8006\n```\n\nThen open the MCP Inspector at `http://localhost:8006`.\n\n## Development\n\n```bash\ngit clone https://github.com/qso-graph/pota-mcp.git\ncd pota-mcp\npip install -e .\n```\n\n## License\n\nGPL-3.0-or-later\n",
  "bytes": 2991,
  "sha": "9877820cc4c6b6fcbcb22e1aa25135739a6042ee72b4087f8519ab283bf3ed32",
  "repo_slug": "qso-graph/pota-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qso_graph_pota_mcp_692262c8/readme"
}