Netlogger Mcp

io.github.qso-graphPublished by GitHub account qso-graphv0.3.1Updated Nov 3, 2026

NetLogger MCP server. Nets on the air, live check-ins and who's up, past nets.

VerifiedSTDIODesktop onlyLocation & LifestyleCommunication & Collaboration

Overview

AI-generated overview

Read-only MCP server that lets an assistant list amateur-radio nets on the air, see live check-ins and who is up now, and review past nets.

What you can do
  • List nets currently on the air with frequency, band, mode, net control and monitoring count, optionally filtered by name
  • Get a live net's check-in list plus the pointer station being worked now
  • List closed nets from the last few days with the net IDs needed for past check-ins
  • Get a closed net's check-in list
  • Save the user's callsign once and report version information
When to use it
Useful for radio amateurs and net participants who want to ask an assistant what nets are running, whether a band has activity, who has checked in, or what happened on a recent net, without opening NetLogger itself.
Requirements
Runs locally as a Python package launched with uvx; no API key. A callsign is needed once, either asked for by the assistant or set through the NETLOGGER_MCP_CALLSIGN environment variable, and is stored in a settings file under the user's config directory. Network access to NetLogger's public XML Data Service is required.
Before you install
Read-only, but every request sends the user's callsign to NetLogger in the User-Agent header, so the operator can see who is asking. NetLogger is donation-funded and rate-limited; the server enforces per-call limits, shared budgets and caching, and may return stale answers with an age instead of fresh data. The callsign is written to a local settings file.

Installation

In SourceWeft

  1. Open Netlogger Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

netlogger-mcp

[PyPI] [MCP Registry]

MCP server for NetLogger: nets on the air now, live check-in lists and who's up, and past nets and their check-ins, through any MCP-compatible AI assistant.

Data from NetLogger's public XML Data Service (API 1.3). Part of the qso-graph project. No API key needed. Your callsign is asked for once (see below).

Install

bash
uvx netlogger-mcp            # run it; nothing to install

Tools

ToolDescriptionKey Parameters
netlogger_active_netsNets on the air now: frequency, band, mode, net control, logger, monitoring countname_like
netlogger_checkinsA live net's check-in list, plus the pointer (the station being worked now)server_name, net_name
netlogger_past_netsClosed nets over the last N days, with the net IDs past check-ins needinterval_days, name_like
netlogger_past_checkinsA closed net's check-in listserver_name, net_name, net_id
netlogger_set_callsignSave your callsign (asked once, on first use)callsign
get_version_infoService version + upstream spec version (fleet identity attestation)—

What is NetLogger?

NetLogger is the logging program many amateur-radio nets use: net control or a logger keeps the check-in list, and anyone can follow the net live. Its server publishes active nets, check-in lists and past nets through a public API.

Your Callsign

Every request tells NetLogger which station is asking, so it can tell one user from another:

netlogger-mcp/<version> (KI7MT; +https://github.com/qso-graph/netlogger-mcp)

The version is the installed one—it is read from the package, not written here.

On first use the assistant asks for your callsign and saves it. You're asked once. To set it yourself, use NETLOGGER_MCP_CALLSIGN=KI7MT.

It's saved in settings.json, in ~/.config/netlogger-mcp/ (Linux), ~/Library/Application Support/netlogger-mcp/ (macOS) or %APPDATA%\netlogger-mcp\ (Windows).

Good Neighbor Policy

NetLogger is a donation-funded service on one server, and it limits how often each call may be made. We keep to those limits:

MeasureDetail
NetLogger's call limitsGetActiveNets 1/min, GetCheckins 3/min, GetPastNets 1/min, GetPastNetCheckins 10/min. Checked before a request is sent, never after.
One budget per userEvery copy you run (Claude Desktop, Claude Code, a script) shares one budget, through a locked file beside settings.json.
Shared answersEvery copy also shares the answers it fetched, so a copy that has hit the limit gets another copy's recent answer, with its age, instead of an error.
Response cachingActive nets 60 s, check-ins 20 s, past nets 60 s, past check-ins 1 hour. Filtering by name costs no extra calls.
How old an answer isEvery answer has as_of_utc (when it was given) and age_seconds (how old the data is), so it was fetched at as_of_utc minus age_seconds.
Stale answers over errorsWhen a limit is reached, the last answer comes back with its age rather than a new request.
429 back-offA "too many requests" on any call stops all calls for at least a minute, longer if NetLogger asks.
Past-net windowsMore than 7 days of past nets needs a name filter, NetLogger's rule to protect its server.
Request timeout15-second timeout.
User-Agent headerEvery request names this project and your callsign, so NetLogger's operators can see who is asking.

Bands and Frequencies

NetLogger's band and frequency are whatever the logger typed (40M, 75M, DMR, 7033, 3918 KHz, 147.030 91.5, TG 3141). They're returned as typed, and beside them, only when the text can be read reliably: frequency_mhz, band_adif (the ADIF band, from ADIF 3.1.7's Band enumeration), tone_hz and talkgroup. A frequency outside the amateur bands (for example, GMRS) gets no band_adif.

Privacy

NetLogger's check-in data includes street addresses and ZIP codes, and past nets include the IP address of whoever opened them. None of these are ever returned.

Quick Start

Configure your MCP client

netlogger-mcp works with any MCP-compatible client. Add the server config and restart. The tools appear automatically.

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

json
{  "mcpServers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}
Claude Code

Add to .claude/settings.json:

json
{  "mcpServers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}
ChatGPT Desktop
json
{  "mcpServers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}
Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}
VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

json
{  "servers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}
Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

json
{  "mcpServers": {    "netlogger": {      "command": "uvx",      "args": ["netlogger-mcp"]    }  }}

Ask questions

"What nets are on the air right now?"

"Are any 80m nets running?"

"Who's checked into the county ARES net, and who's up now?"

"Which nets ran in the last three days?"

"Show me the check-ins from last night's net."

As a Python Library

The same code works without an AI, with the same limits and cache. A library can't ask for your callsign, so you pass it in:

python
from netlogger_mcp.netlogger import NetLoggerSource
nl = NetLoggerSource(callsign="KI7MT")for net in nl.active_nets()["nets"]:    live = nl.checkins(net["server"], net["name"])    print(net["name"], "up now:", live["pointer_callsign"])

Apps can also name themselves, using ADIF's PROGRAMID and PROGRAMVERSION: NetLoggerSource(callsign="KI7MT", program_id="MyLogger", program_version="1.0").

Testing Without Network

bash
NETLOGGER_MCP_MOCK=1 netlogger-mcp

MCP Inspector

bash
netlogger-mcp --transport streamable-http --port 8014

Development

bash
git clone https://github.com/qso-graph/netlogger-mcp.gitcd netlogger-mcpuv sync --group devuv run pytest

License

GPL-3.0-or-later. adif_band.json is the ADIF 3.1.7 Band enumeration, the work of the ADIF Developers Group (adif.org.uk), included unchanged.

Source: README.md at commit be561a4

Tools

6

get_version_info

Get Version Info

Get netlogger-mcp's version, the NetLogger API version it is built for, and the version of the records it returns.

Takes no parameters.

netlogger_set_callsign

Netlogger Set Callsign

Save the user's amateur radio callsign. Needed once, before the first lookup. NetLogger is told which station is asking, in every request, so it can tell one user from another. Ask the user for their own callsign; don't guess it.

Parameterscallsignrequired

netlogger_active_nets

Netlogger Active Nets

List nets on the air now.

Parametersname_like

netlogger_checkins

Netlogger Checkins

Get a live net's check-in list, and the pointer: the serial number of the station net control is working now.

Parametersnet_namerequiredserver_namerequired

netlogger_past_nets

Netlogger Past Nets

List closed nets over the last few days, with the net IDs netlogger_past_checkins needs.

Parametersname_likeinterval_days

netlogger_past_checkins

Netlogger Past Checkins

Get a closed net's check-in list.

Parametersnet_idrequirednet_namerequiredserver_namerequired

Version history

9
  1. v0.3.1LatestOct 29, 2026
  2. v0.2.2Oct 26, 2026
  3. v0.2.1Oct 26, 2026
  4. v0.2.0Oct 13, 2026
  5. v0.1.10Oct 11, 2026
  6. v0.1.9Oct 7, 2026
  7. v0.1.8Oct 6, 2026
  8. v0.1.4Sep 29, 2026
  9. v0.1.3Sep 29, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts