Lotw MCP Server

@qso-graph

Repository Homepage

Basic information

About Lotw MCP Server

MCP server for ARRL Logbook of The World — QSO query, QSL status, DXCC credit

#amateur-radio#lotw#qsl#arrl#logging

Lotw MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lotw": {
      "command": "lotw-mcp"
    }
  }
}

Lotw MCP Server tools

Yes

Overview

What is Lotw Mcp?

Lotw Mcp is an MCP server for the ARRL Logbook of The World (LoTW) that lets you query confirmations, uploaded QSOs, DXCC credits, and user activity through any MCP‑compatible AI assistant. It is part of the qso‑graph project and is read‑only – uploads are out of scope.

How to use Lotw Mcp?

Install with pip install lotw-mcp, then set up credentials using qso-graph-auth (e.g., qso-auth persona create, qso-auth persona provider, qso-auth persona secret). Configure your MCP client (Claude Desktop, Claude Code, ChatGPT Desktop, Cursor, VS Code, Gemini CLI) with the lotw-mcp command. For testing without credentials, set LOTW_MCP_MOCK=1. Use lotw-mcp --transport streamable-http --port 8004 to run with MCP Inspector.

Key features of Lotw Mcp

Query confirmed QSLs with band/mode/call/date filters.
Query all uploaded QSOs, confirmed or unconfirmed.
Retrieve DXCC award credits from LoTW confirmations.
Download QSOs as an ADIF file.
Check if a callsign uses LoTW (public, no credentials).
Read‑only – no upload capability.

Use cases of Lotw Mcp

Ask “How many LoTW confirmations did I get this month?”
Ask “Show me all unconfirmed 20m FT8 QSOs uploaded to LoTW in the last 90 days.”
Ask “What DXCC credits do I have on 40m CW?”
Ask “Does JA1ABC use LoTW? When did they last upload?”
Automate querying LoTW data through an AI assistant without manual logins.

Frequently asked questions

How is Lotw Mcp different from direct LoTW access?

Lotw Mcp is read‑only and designed for use with AI assistants. Uploads require TQSL digital signatures and are out of scope.

What dependencies does Lotw Mcp require?

It requires Python and the `lotw-mcp` package. Credential management uses `qso-graph-auth`. No other runtime dependencies are listed.

Where does the data live?

Data is fetched live from LoTW servers. The public user activity CSV is cached locally for 7 days.

What are the known performance limits?

LoTW can be slow – large queries may take 30–60 seconds. Lotw Mcp uses a 120‑second timeout. Using date filters (`since`, `start_date`) is recommended to limit result sets.

How does authentication work?

Most tools require credentials managed via `qso-graph-auth` personas. The `lotw_user_activity` tool is public and works without any credentials.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K