netlogger-mcp 0.1.0__tar.gz

netlogger_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+# Cancel superseded runs on the same ref (push or PR) so we don't waste
+# minutes when commits land in rapid succession.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: pytest (${{ matrix.os }}, ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Most hams run Windows, and the shared call budget uses a different
+        # file lock there (msvcrt) than on Linux and macOS (flock).
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        include:
+          - os: windows-latest
+            python-version: "3.10"
+          - os: windows-latest
+            python-version: "3.13"
+          - os: macos-latest
+            python-version: "3.13"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package + test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install -e ".[test]"
+
+      - name: Run unit tests (L2)
+        run: python -m pytest tests --ignore=tests/test_security.py -v
+
+      - name: Run security tests
+        run: python -m pytest tests/test_security.py -v
+
+  ci-all-green:
+    name: ci-all-green
+    needs: [test]
+    runs-on: ubuntu-latest
+    if: always()
+    steps:
+      - name: Verify required jobs all succeeded
+        run: |
+          if [[ "${{ needs.test.result }}" != "success" ]]; then
+            echo "FAIL: test matrix did not all succeed (result=${{ needs.test.result }})"
+            exit 1
+          fi
+          echo "All required CI jobs passed."

netlogger_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,70 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  security:
+    name: Security gates
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install test dependencies
+        run: pip install -e ".[test]" pip-audit
+
+      - name: Run security test suite
+        run: python -m pytest tests/test_security.py -v
+
+      - name: Audit dependencies for vulnerabilities
+        run: pip-audit --strict --desc 2>&1 || true
+
+      - name: Grep check — no subprocess/shell
+        run: |
+          if grep -rn 'subprocess\.\|os\.system\|shell=True' src/; then
+            echo "FAIL: subprocess/shell found in source"
+            exit 1
+          fi
+
+      - name: Grep check — no plaintext http://
+        run: |
+          if grep -rn 'http://' src/ | grep -v 'localhost\|127\.0\.0\.1\|::1'; then
+            echo "FAIL: non-HTTPS URL found in source"
+            exit 1
+          fi
+
+      - name: Grep check — no credential logging
+        run: |
+          if grep -rn -i 'print.*password\|print.*api_key\|logging.*password\|logging.*api_key' src/; then
+            echo "FAIL: credential logging found in source"
+            exit 1
+          fi
+
+  publish:
+    name: Build and publish to PyPI
+    needs: security
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Required for trusted publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

netlogger_mcp-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.venv/
+uv.lock

netlogger_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.0 (2026-09-28)
+
+- Tools for every documented NetLogger API 1.3 call: active nets, live check-ins with the pointer,
+  past nets, past check-ins; plus `get_version_info`.
+- Records follow a source-independent contract (`schema/contract.schema.json`, 0.1).
+- NetLogger's call limits enforced before sending; answers cached; a 429 on any call stops all
+  calls for the back-off.
+- Every request names the station using it (callsign in the User-Agent); no anonymous mode. The MCP
+  asks once on first use and saves it (`netlogger_set_callsign`); the library requires it.
+- Apps built on the library name themselves with ADIF's PROGRAMID and PROGRAMVERSION, which lead
+  the User-Agent (`OM-Logger/0.3 netlogger-mcp/0.1.0 (KI7MT; +…)`).
+- The call budget is shared by every copy for the user account (a locked state file), so two AI apps
+  can't double the calls. It never fails open, and a copy that fell back rejoins once the file works.
+- Street, ZIP and IP address never returned.
+- `NetLoggerSource` usable as a plain Python library.

netlogger_mcp-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  For the full license text, see <https://www.gnu.org/licenses/gpl-3.0.html>

netlogger_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.5
+Name: netlogger-mcp
+Version: 0.1.0
+Summary: MCP server for net logging: live and past nets and check-ins, rate-limited to NetLogger's guidelines
+Project-URL: Homepage, https://qso-graph.io
+Project-URL: Repository, https://github.com/qso-graph/netlogger-mcp
+Project-URL: Issues, https://github.com/qso-graph/netlogger-mcp/issues
+Author-email: "Greg Beam, KI7MT" <ki7mt@yahoo.com>
+License: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: amateur-radio,check-ins,ham-radio,mcp,model-context-protocol,net-control,netlogger,omiss
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: defusedxml>=0.7
+Requires-Dist: fastmcp>=3.0
+Provides-Extra: test
+Requires-Dist: jsonschema; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Description-Content-Type: text/markdown
+
+# netlogger-mcp
+
+MCP server and Python library for amateur-radio net logging: which nets are on the air, who has
+checked in, who's up now, and what past nets logged.
+
+- **Read-only.** It never writes to a net.
+- **One contract, more than one source.** Every answer uses the same net and check-in records
+  ([`schema/contract.schema.json`](src/netlogger_mcp/schema/contract.schema.json)), whatever logging
+  system is behind them. The first source is [NetLogger](https://www.netlogger.org)'s public XML Data
+  Service (API 1.3). The next is the OM-Logger being built for OMISS.
+- **A good neighbour.** NetLogger is a donation-funded service. This server never exceeds
+  NetLogger's published call limits, caches every answer, and backs off when told to.
+- **Private details stay out.** Street addresses, ZIP codes and IP addresses in NetLogger's data
+  have no place in the contract, so they never reach an AI, a program or a user.
+
+Status: 0.1.0, first release.
+
+## Tools
+
+| Tool | NetLogger call | Returns |
+|---|---|---|
+| `netlogger_active_nets` | `GetActiveNets` | nets on the air: server, name, frequency, band, mode, net control, logger, opened, monitoring count |
+| `netlogger_checkins` | `GetCheckins` | a live net's check-ins, the count, and the **pointer** (the station up now) |
+| `netlogger_past_nets` | `GetPastNets` | closed nets over the last N days, with the net IDs past check-ins need |
+| `netlogger_past_checkins` | `GetPastNetCheckins` | a closed net's check-ins |
+| `get_version_info` | none | server version, NetLogger API version, contract version |
+
+These are all the calls NetLogger's API 1.3 documents. `GetPointer` is deprecated; the pointer comes
+with `GetCheckins`, so it's never called.
+
+## Call limits
+
+| Call | NetLogger's limit | Answers reused for |
+|---|---|---|
+| `GetActiveNets` | 1 a minute | 60 s; the name filter is applied locally, so any number of filters cost one call |
+| `GetCheckins` | 3 a minute | 20 s per net |
+| `GetPastNets` | 1 a minute | 60 s per query |
+| `GetPastNetCheckins` | 10 a minute | an hour (a closed net's list doesn't change) |
+
+A limit is checked before a request is sent, never after. Over the limit, the answer comes from
+cache with its age (`age_seconds`, `stale`), or the result says when to try again. A
+`429 Too Many Requests` on any call stops **all** calls to NetLogger for at least a minute, longer
+if NetLogger's `Retry-After` asks. NetLogger's anti-flooding is aimed at the client, and every call
+reaches the same server. Past nets older than 7 days need a name filter (NetLogger's rule).
+
+**One budget per user account.** Every request carries your callsign, so to NetLogger all your
+copies are one station: Claude Desktop and Claude Code each running the server, a script using the
+library, and so on. They share one budget through a small state file (`limits.json`, beside the
+settings file), updated under a lock the operating system enforces between processes. Another
+account on the same computer has its own folder, and its own callsign. The rules:
+- **A 429 seen by any copy stops them all.**
+- **It never fails open.** If the file is unreadable, it assumes the whole budget was spent and
+  waits a full minute. If the file can't be used at all, that copy keeps to the limits on its own,
+  starting with a minute's pause, and logs why.
+- **One glitch doesn't strand a copy.** A copy on its own tries the file again after a minute. Once
+  the file works, it rejoins the shared budget and carries back the calls it made on its own.
+- **Clock changes don't help.** If the clock goes back, recorded calls count as "now", so they stay
+  in the window longer, not shorter.
+
+## Install
+
+```bash
+pip install netlogger-mcp
+```
+
+Claude Code / Claude Desktop:
+
+```json
+"netlogger": { "command": "netlogger-mcp" }
+```
+
+No API key or password is needed. **Your callsign is.**
+
+## Your callsign
+
+Every request tells NetLogger which station is asking, in the User-Agent:
+
+```
+netlogger-mcp/0.1.0 (KI7MT; +https://github.com/qso-graph/netlogger-mcp)
+```
+
+That way, NetLogger can tell users apart. Without it, every install would look like one client, and
+one misbehaving install could get everyone blocked. There is no anonymous mode.
+
+- **Nothing to configure.** On first use, the server says it needs your callsign, the AI asks you,
+  and it's saved (`netlogger_set_callsign`). You're asked once.
+- **Saved** in a small settings file: `~/.config/netlogger-mcp/settings.json` on Linux,
+  `~/Library/Application Support/netlogger-mcp/` on macOS, `%APPDATA%\netlogger-mcp\` on Windows.
+  A callsign is public, not a password.
+- **Or set it** with `NETLOGGER_MCP_CALLSIGN=KI7MT`, which overrides the file.
+- Changing the callsign never resets the call limits.
+
+For testing without the network, set `NETLOGGER_MCP_MOCK=1` to answer from bundled synthetic samples.
+
+## As a library
+
+Programs that don't need an AI use the same code directly, with the same limits, cache and contract.
+A library can't ask anyone anything, so it requires the callsign: the program passes in the signed-in
+user's callsign, or the club's for a shared server.
+
+```python
+from netlogger_mcp.netlogger import NetLoggerSource
+
+# callsign: required (no valid callsign: NetLoggerError, nothing sent).
+# program_id / program_version: your app, as in ADIF's PROGRAMID and PROGRAMVERSION (optional).
+nl = NetLoggerSource(callsign="KI7MT", program_id="OM-Logger", program_version="0.3")
+# User-Agent: OM-Logger/0.3 netlogger-mcp/0.1.0 (KI7MT; +https://github.com/qso-graph/netlogger-mcp)
+for net in nl.active_nets(name_like="OMISS")["nets"]:
+    live = nl.checkins(net["server"], net["name"])
+    print(net["name"], "up now:", live["pointer"])
+```
+
+Programs in other languages can run the server and call its tools over MCP (JSON-RPC on stdio or
+HTTP).
+
+## Terms and privacy
+
+NetLogger's terms allow API use "in direct support of Radio Communications". This server is for that.
+It sends a User-Agent naming this project and the station using it. Parsing follows the spec: no assumptions about node order
+or count, unknown elements ignored, `<Warning>` messages logged for the developer. XML is parsed with
+`defusedxml`.
+
+## Development
+
+```bash
+pip install -e ".[test]"
+pytest
+```
+
+Part of [qso-graph](https://github.com/qso-graph). Licensed GPL-3.0-or-later.

netlogger_mcp-0.1.0/README.md

@@ -0,0 +1,130 @@
+# netlogger-mcp
+
+MCP server and Python library for amateur-radio net logging: which nets are on the air, who has
+checked in, who's up now, and what past nets logged.
+
+- **Read-only.** It never writes to a net.
+- **One contract, more than one source.** Every answer uses the same net and check-in records
+  ([`schema/contract.schema.json`](src/netlogger_mcp/schema/contract.schema.json)), whatever logging
+  system is behind them. The first source is [NetLogger](https://www.netlogger.org)'s public XML Data
+  Service (API 1.3). The next is the OM-Logger being built for OMISS.
+- **A good neighbour.** NetLogger is a donation-funded service. This server never exceeds
+  NetLogger's published call limits, caches every answer, and backs off when told to.
+- **Private details stay out.** Street addresses, ZIP codes and IP addresses in NetLogger's data
+  have no place in the contract, so they never reach an AI, a program or a user.
+
+Status: 0.1.0, first release.
+
+## Tools
+
+| Tool | NetLogger call | Returns |
+|---|---|---|
+| `netlogger_active_nets` | `GetActiveNets` | nets on the air: server, name, frequency, band, mode, net control, logger, opened, monitoring count |
+| `netlogger_checkins` | `GetCheckins` | a live net's check-ins, the count, and the **pointer** (the station up now) |
+| `netlogger_past_nets` | `GetPastNets` | closed nets over the last N days, with the net IDs past check-ins need |
+| `netlogger_past_checkins` | `GetPastNetCheckins` | a closed net's check-ins |
+| `get_version_info` | none | server version, NetLogger API version, contract version |
+
+These are all the calls NetLogger's API 1.3 documents. `GetPointer` is deprecated; the pointer comes
+with `GetCheckins`, so it's never called.
+
+## Call limits
+
+| Call | NetLogger's limit | Answers reused for |
+|---|---|---|
+| `GetActiveNets` | 1 a minute | 60 s; the name filter is applied locally, so any number of filters cost one call |
+| `GetCheckins` | 3 a minute | 20 s per net |
+| `GetPastNets` | 1 a minute | 60 s per query |
+| `GetPastNetCheckins` | 10 a minute | an hour (a closed net's list doesn't change) |
+
+A limit is checked before a request is sent, never after. Over the limit, the answer comes from
+cache with its age (`age_seconds`, `stale`), or the result says when to try again. A
+`429 Too Many Requests` on any call stops **all** calls to NetLogger for at least a minute, longer
+if NetLogger's `Retry-After` asks. NetLogger's anti-flooding is aimed at the client, and every call
+reaches the same server. Past nets older than 7 days need a name filter (NetLogger's rule).
+
+**One budget per user account.** Every request carries your callsign, so to NetLogger all your
+copies are one station: Claude Desktop and Claude Code each running the server, a script using the
+library, and so on. They share one budget through a small state file (`limits.json`, beside the
+settings file), updated under a lock the operating system enforces between processes. Another
+account on the same computer has its own folder, and its own callsign. The rules:
+- **A 429 seen by any copy stops them all.**
+- **It never fails open.** If the file is unreadable, it assumes the whole budget was spent and
+  waits a full minute. If the file can't be used at all, that copy keeps to the limits on its own,
+  starting with a minute's pause, and logs why.
+- **One glitch doesn't strand a copy.** A copy on its own tries the file again after a minute. Once
+  the file works, it rejoins the shared budget and carries back the calls it made on its own.
+- **Clock changes don't help.** If the clock goes back, recorded calls count as "now", so they stay
+  in the window longer, not shorter.
+
+## Install
+
+```bash
+pip install netlogger-mcp
+```
+
+Claude Code / Claude Desktop:
+
+```json
+"netlogger": { "command": "netlogger-mcp" }
+```
+
+No API key or password is needed. **Your callsign is.**
+
+## Your callsign
+
+Every request tells NetLogger which station is asking, in the User-Agent:
+
+```
+netlogger-mcp/0.1.0 (KI7MT; +https://github.com/qso-graph/netlogger-mcp)
+```
+
+That way, NetLogger can tell users apart. Without it, every install would look like one client, and
+one misbehaving install could get everyone blocked. There is no anonymous mode.
+
+- **Nothing to configure.** On first use, the server says it needs your callsign, the AI asks you,
+  and it's saved (`netlogger_set_callsign`). You're asked once.
+- **Saved** in a small settings file: `~/.config/netlogger-mcp/settings.json` on Linux,
+  `~/Library/Application Support/netlogger-mcp/` on macOS, `%APPDATA%\netlogger-mcp\` on Windows.
+  A callsign is public, not a password.
+- **Or set it** with `NETLOGGER_MCP_CALLSIGN=KI7MT`, which overrides the file.
+- Changing the callsign never resets the call limits.
+
+For testing without the network, set `NETLOGGER_MCP_MOCK=1` to answer from bundled synthetic samples.
+
+## As a library
+
+Programs that don't need an AI use the same code directly, with the same limits, cache and contract.
+A library can't ask anyone anything, so it requires the callsign: the program passes in the signed-in
+user's callsign, or the club's for a shared server.
+
+```python
+from netlogger_mcp.netlogger import NetLoggerSource
+
+# callsign: required (no valid callsign: NetLoggerError, nothing sent).
+# program_id / program_version: your app, as in ADIF's PROGRAMID and PROGRAMVERSION (optional).
+nl = NetLoggerSource(callsign="KI7MT", program_id="OM-Logger", program_version="0.3")
+# User-Agent: OM-Logger/0.3 netlogger-mcp/0.1.0 (KI7MT; +https://github.com/qso-graph/netlogger-mcp)
+for net in nl.active_nets(name_like="OMISS")["nets"]:
+    live = nl.checkins(net["server"], net["name"])
+    print(net["name"], "up now:", live["pointer"])
+```
+
+Programs in other languages can run the server and call its tools over MCP (JSON-RPC on stdio or
+HTTP).
+
+## Terms and privacy
+
+NetLogger's terms allow API use "in direct support of Radio Communications". This server is for that.
+It sends a User-Agent naming this project and the station using it. Parsing follows the spec: no assumptions about node order
+or count, unknown elements ignored, `<Warning>` messages logged for the developer. XML is parsed with
+`defusedxml`.
+
+## Development
+
+```bash
+pip install -e ".[test]"
+pytest
+```
+
+Part of [qso-graph](https://github.com/qso-graph). Licensed GPL-3.0-or-later.

netlogger_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "netlogger-mcp"
+version = "0.1.0"
+description = "MCP server for net logging: live and past nets and check-ins, rate-limited to NetLogger's guidelines"
+readme = "README.md"
+license = {text = "GPL-3.0-or-later"}
+authors = [{name = "Greg Beam, KI7MT", email = "ki7mt@yahoo.com"}]
+requires-python = ">=3.10"
+dependencies = [
+    "fastmcp>=3.0",
+    "defusedxml>=0.7",
+]
+keywords = [
+    "amateur-radio", "ham-radio", "netlogger", "net-control", "check-ins",
+    "mcp", "model-context-protocol", "omiss",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Communications :: Ham Radio",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "jsonschema"]
+
+[project.urls]
+Homepage = "https://qso-graph.io"
+Repository = "https://github.com/qso-graph/netlogger-mcp"
+Issues = "https://github.com/qso-graph/netlogger-mcp/issues"
+
+[project.scripts]
+netlogger-mcp = "netlogger_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/netlogger_mcp"]

netlogger_mcp-0.1.0/src/netlogger_mcp/__init__.py

@@ -0,0 +1,21 @@
+"""MCP server for net logging: live and past nets and check-ins."""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+from typing import Final
+
+try:
+    _pkg_version = version("netlogger-mcp")
+except PackageNotFoundError:  # local dev / editable installs without dist metadata
+    _pkg_version = "0.0.0-dev"
+
+__version__: Final[str] = _pkg_version
+
+# The NetLogger API this server is built against: "The NetLogger XML Data
+# Service Interface Specification" v1.3 (K0JDD, 2023-12-01).
+__spec_version__: Final[str] = "netlogger-xml-api-1.3"
+
+# Version of the records the tools return (schema/contract.schema.json).
+# Every source (NetLogger now, the OM-Logger next) maps onto this.
+__contract_version__: Final[str] = "0.1"

netlogger_mcp-0.1.0/src/netlogger_mcp/contract.py

@@ -0,0 +1,54 @@
+"""The records every tool returns, whatever the source.
+
+Each source maps its own format onto these fields and nothing else, so a
+field a source sends that isn't listed here (a street address, a ZIP code, an
+IP address, or anything added later) can never reach a user.
+schema/contract.schema.json is the published form.
+"""
+
+from __future__ import annotations
+
+# contract field -> NetLogger element(s), first present wins
+NET_FIELDS: dict[str, tuple[str, ...]] = {
+    "name": ("NetName",),
+    "current_name": ("AltNetName",),
+    "frequency": ("Frequency",),
+    "band": ("Band",),
+    "mode": ("Mode",),
+    "net_control": ("NetControl",),
+    "logger": ("Logger",),
+    "opened": ("Date",),
+    "monitoring": ("SubscriberCount",),
+    # past nets only
+    "net_id": ("NetID",),
+    "closed": ("ClosedAt",),
+    "last_activity": ("LastActivity",),
+    "aim": ("AIM",),
+    "aim_update_ms": ("UpdateInterval",),
+    "inactivity_timeout_minutes": ("InactivityTimer", "InactivitytTimer"),  # the spec spells it both ways
+    "auto_closed": ("Assassinated",),
+}
+
+CHECKIN_FIELDS: dict[str, tuple[str, ...]] = {
+    "serial": ("SerialNo",),
+    "callsign": ("Callsign",),
+    "first_name": ("FirstName",),
+    "preferred_name": ("PreferredName",),
+    "city": ("CityCountry",),
+    "county": ("County",),
+    "state": ("State",),
+    "country": ("Country",),
+    "dxcc": ("DXCC",),
+    "grid": ("Grid",),
+    "status": ("Status",),
+    "remarks": ("Remarks",),
+    "qsl_info": ("QSLInfo",),
+    "member_id": ("MemberID",),
+}
+
+INT_FIELDS = {"monitoring", "net_id", "aim_update_ms", "inactivity_timeout_minutes", "serial", "dxcc"}
+BOOL_FIELDS = {"aim", "auto_closed"}  # Y/N
+TIME_FIELDS = {"opened", "closed", "last_activity"}
+
+# Never returned by any tool. Listed so tests can prove it.
+PRIVATE_SOURCE_FIELDS = ("Street", "Zip", "srcIP")