Lotw Mcp

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.

FAQ from Lotw Mcp

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.