Metadata-Version: 2.4
Name: mcrepeaterbook
Version: 2026.2.26
Summary: MCP server for querying amateur radio repeaters from RepeaterBook.com
Author-email: Ryan Malloy <ryan@supported.systems>
License-Expression: MIT
Keywords: amateur-radio,ham-radio,mcp,repeater,repeaterbook
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Ham Radio
Requires-Python: >=3.10
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.24; extra == 'test'
Requires-Dist: pytest>=8.0; extra == 'test'
Requires-Dist: respx>=0.22; extra == 'test'
Description-Content-Type: text/markdown

# mcrepeaterbook

MCP server for querying amateur radio repeaters from [RepeaterBook.com](https://www.repeaterbook.com).

## Install

```bash
uvx mcrepeaterbook
```

## Tools

| Tool | Description |
|------|-------------|
| `search_repeaters` | Search NA repeaters by state, city, callsign, frequency, mode |
| `search_repeaters_worldwide` | Search international repeaters (Rest of World) |
| `find_nearby` | Proximity search — find repeaters within N miles of coordinates |
| `find_emergency_repeaters` | Find ARES/RACES/SKYWARN-affiliated repeaters |

## Configuration

Set environment variables (or `.env` file):

| Variable | Required | Description |
|----------|----------|-------------|
| `REPEATERBOOK_EMAIL` | Yes | Your RepeaterBook account email |
| `REPEATERBOOK_API_KEY` | After March 2026 | API token |
| `REPEATERBOOK_CACHE_TTL` | No | Cache duration in seconds (default: 3600) |

## Add to Claude Code

```bash
claude mcp add mcrepeaterbook -- uvx mcrepeaterbook
```

## Data Attribution

All repeater data sourced from [RepeaterBook.com](https://www.repeaterbook.com). Personal, non-commercial use only.
