repeaterbook
Advanced tools
 | |
|---|---|
 |     |
 |    |
 |   |
 |     |
 |      |
Unofficial project. RepeaterBook Python Client is an independent, community-maintained library and MCP server, and is not affiliated with, endorsed by, or officially supported by RepeaterBook.com. "RepeaterBook" is a trademark of its respective owner. For the official website and API, visit https://repeaterbook.com/.
Welcome to the RepeaterBook Python Client documentation!
RepeaterBook Python Client is an unofficial, third-party Python library and Model Context Protocol (MCP) server that provides a powerful and convenient interface to the RepeaterBook.com API — the world's largest database of amateur radio repeaters. Use it as a library to programmatically download, query, and analyze repeater data, or run the bundled MCP server to give AI agents and LLM tools the same repeater lookup capabilities.
You need a RepeaterBook API token. No application registration required — this library is already registered as RepeaterBook Python Client (App #114). Log in to RepeaterBook, open API Applications, find App #114, and generate a token. Then expose it as the
REPEATERBOOKenvironment variable (for exampleexport REPEATERBOOK="rbuapp_..."). Keep the library's defaultUser-Agent— see the Authentication guide.
import asyncio
import os
from repeaterbook import RepeaterBook, Repeater
from repeaterbook.services import RepeaterBookAPI
from repeaterbook.models import ExportQuery, Status
from repeaterbook.utils import LatLon, Radius
from repeaterbook.queries import filter_radius, square, band, Bands
import pycountry
async def find_nearby_repeaters():
# Download repeater data
api = RepeaterBookAPI(app_token=os.environ["REPEATERBOOK"])
brazil = pycountry.countries.get(name="Brazil")
repeaters = await api.download(query=ExportQuery(countries={brazil}))
# Store in local database
rb = RepeaterBook()
rb.populate(repeaters)
# Find DMR repeaters within 50km of São Paulo
sao_paulo = LatLon(lat=-23.5505, lon=-46.6333)
radius = Radius(origin=sao_paulo, distance=50)
nearby = rb.query(
square(radius),
Repeater.dmr_capable == True,
Repeater.operational_status == Status.ON_AIR,
band(Bands.CM_70) # 70cm band
)
filtered = filter_radius(nearby, radius)
# Display results (filter_radius returns repeaters sorted by distance)
from haversine import haversine
for rep in filtered[:5]:
distance = haversine(radius.origin, (rep.latitude, rep.longitude), unit=radius.unit)
print(f"{distance:.1f}km - {rep.frequency:.4f} MHz - {rep.callsign}")
asyncio.run(find_nearby_repeaters())
Prefer to drive RepeaterBook from an AI agent? The unofficial MCP server ships as
the repeaterbook-mcp console script behind the mcp extra. Point your MCP
client at uvx and nothing needs installing up front:
{
"mcpServers": {
"repeaterbook": {
"command": "uvx",
"args": ["--from", "repeaterbook[mcp]", "repeaterbook-mcp"],
"env": {
"REPEATERBOOK_WORKING_DIR": "~/.repeaterbook",
"REPEATERBOOK_APP_TOKEN": "rbuapp_..."
}
}
}
}
REPEATERBOOK_APP_TOKEN is the same App #114 token described above; the
server won't start without it.
That exposes four tools — sync_repeaters, search_repeaters, and
get_repeater, which return a stable, source-agnostic repeater spec, plus
clear_local_data to wipe the local store and response cache. See the
MCP Server guide for the full tool reference, filter vocabulary,
and configuration options.
Read RepeaterBook.com's official API documentation for more information about the upstream API.
repeaterbook is available on PyPI:
# With uv (recommended)
uv add repeaterbook
# With pip
pip install repeaterbook
# With Poetry
poetry add repeaterbook
The MCP server lives behind the mcp extra. Most MCP clients should invoke it
via uvx, with no install step at all:
# Run on demand, no install (what MCP clients should use)
uvx --from "repeaterbook[mcp]" repeaterbook-mcp
# Or install it persistently
uv tool install "repeaterbook[mcp]"
# Or add it as a project dependency
uv add "repeaterbook[mcp]"
pip install "repeaterbook[mcp]"
You can also install the latest version of the code directly from GitHub:
# With uv
uv add git+https://github.com/MicaelJarniac/repeaterbook
# With pip
pip install git+https://github.com/MicaelJarniac/repeaterbook
# With Poetry
poetry add git+https://github.com/MicaelJarniac/repeaterbook
mcp extra additionally installs fastmcp, pydantic-settings,
and pydantic[email] (for the EmailStr contact setting)Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
More details can be found in CONTRIBUTING.
 Micael Jarniac 🐛 💻 🖋 🔣 📖 💡 🤔 🚇 🚧 📆 💬 🔬 👀 🔧 ⚠️ 📓 |  ada mancini 🐛 🤔 📓 |  aaronjbrown 💻 📖 🤔 ⚠️ |  Erica Morton 🐛 💻 📖 🔬 ⚠️ |
This project was created with the MicaelJarniac/crustypy template.
FAQs
Unofficial third-party Python client and MCP server for the RepeaterBook.com API.
The pypi package repeaterbook receives a total of 250 weekly downloads. As such, repeaterbook popularity was classified as not popular.
We found that repeaterbook demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Two compromised GitHub Actions were re-enabled with malicious tags intact, exposing thousands of downstream repositories to Mini Shai-Hulud.
Research
/Security News
A malicious Firefox extension fetches its payload after installation to evade detection, steal Google session cookies, and automate account takeover.
Research
/Security News
The compromise affects MemTensor's MemOS, an open source memory framework for large language models (LLMs) and AI agents. Both npm package @memtensor/memos-cloud-openclaw-plugin and the PyPI package MemoryOS are compromised. They drop cross-platform Go binaries that exfiltrate developer secrets.