verumsignal-mcp 0.2.0__tar.gz

verumsignal_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Verum Signal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

verumsignal_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: verumsignal-mcp
+Version: 0.2.0
+Summary: MCP server for Verum Signal: political debate claims, who said each one and how it was rated.
+Author: Verum Signal LLC
+License-Expression: MIT
+Project-URL: Homepage, https://verumsignal.com
+Project-URL: Documentation, https://verumsignal.com/developers
+Project-URL: Source, https://github.com/brittbart/verumsignal-mcp
+Project-URL: Changelog, https://github.com/brittbart/verumsignal-mcp/blob/main/CHANGELOG.md
+Keywords: mcp,model-context-protocol,debates,politics,claims,elections
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Verum Signal MCP Server
+
+<!-- mcp-name: io.github.brittbart/verumsignal-mcp -->
+
+An MCP server that gives LLM agents Verum Signal's political debate coverage: the claims candidates made, who said each one, and how each was rated. It also searches the claims news outlets report. Requires a Verum Signal API key.
+
+## What the tools do
+
+| Tool | Returns | Explicitly does NOT |
+|---|---|---|
+| `list_debates` | Available debates with claim counts, dates, and status. | Include the claims themselves — call `get_debate_verdicts` for that. |
+| `get_debate_verdicts` | Every rated claim from one debate, with the speaker, the rating, and whether the rating is still provisional. Paginates automatically to completeness. | Truncate silently. If a debate is large enough to hit an internal safety cap, the response includes an explicit `truncated: true` flag rather than quietly returning a partial result. |
+| `list_recent_claims` | Claims reported by news outlets, with their ratings. Pass `q` to find claims about a topic; filter by outlet or rating; without `q`, most recent first. | Return quoted claims an outlet attributes to someone else, or any overall score for an outlet. |
+| `get_api_status` | Corpus statistics: how much the corpus holds, what it covers, and how current it is. | Include per-claim detail — call the other tools for that. |
+
+Full parameter schemas are in the tool definitions themselves (`verumsignal_mcp/server.py`), and are also what any MCP client will show you directly. This table is a summary; the tool definitions are authoritative.
+
+## Install & config
+
+Requires Python 3.9+ and no third-party dependencies.
+
+**With uv** (nothing to install first):
+
+```json
+{
+  "mcpServers": {
+    "verum-signal": {
+      "command": "uvx",
+      "args": ["verumsignal-mcp"],
+      "env": { "VS_API_KEY": "vs_live_..." }
+    }
+  }
+}
+```
+
+**With pip:**
+
+```bash
+pip install verumsignal-mcp
+```
+
+then use `"command": "verumsignal-mcp"` with no `args` in the config above.
+
+**From a clone:** `git clone https://github.com/brittbart/verumsignal-mcp.git` and use `"command": "python3"`, `"args": ["/absolute/path/to/mcp_server.py"]`.
+
+These examples are for Claude Desktop's `claude_desktop_config.json`; other MCP clients take the same command, arguments and environment.
+
+**Verify it works:** ask your agent "which debates does Verum Signal cover?" A correctly wired server returns a list of debates with dates and claim counts. If you see an authentication error, check the key; if you see a connection error, confirm outbound HTTPS access to `api.verumsignal.com` is allowed from wherever the server runs.
+
+## Getting a key
+
+Keys are issued to Verum Signal account holders. See [verumsignal.com/developers](https://verumsignal.com/developers).
+
+## The data boundary
+
+Rating reasoning is not available through the API, and that is kept structurally: the API's queries never fetch the written reasoning behind a rating, and the cache that serves the API never stores it. It isn't a filter applied after the fact — the data simply isn't in what this server can reach.
+
+What this server sends out: an authenticated `GET` request to `api.verumsignal.com` (or an operator-configured `VS_API_BASE`) for each tool call.
+
+What it sends back to the calling agent: whatever that API call returns.
+
+What it never touches: this server makes no network connections to anything other than the configured API host, reads and writes no local files, and includes no telemetry or analytics of any kind. It uses only the Python standard library (`json`, `os`, `sys`, `urllib`).
+
+## Key handling
+
+`VS_API_KEY` is read from the environment and is never hardcoded. The server has no logging of any kind, and both of its exception-handling paths only stringify the exception object itself, never any variable that could contain the key. There is no code path by which the key can reach output, a log, or a file.
+
+You can provide the key two ways:
+
+1. **In the MCP client's config file**, as shown above. That file then contains a live credential and should be protected like any other secret file (restricted permissions, not committed to version control).
+2. **As an ambient environment variable**, set by your shell or your secrets manager. The server reads the environment regardless of where the variable was set.
+
+## Rate limits & quota
+
+Your key's tier sets a per-minute rate and a monthly quota; current limits are on [verumsignal.com/developers](https://verumsignal.com/developers). Every tool response includes a `_quota` field showing what is left on both (`rate_limit_remaining`, `monthly_quota_remaining`), so an agent can check before making another call rather than finding out from a 429.
+
+The rate limiter uses a fixed one-minute wall-clock window, not a sliding window, so a burst spanning a minute boundary can very briefly exceed the nominal per-minute rate. It's bounded, and you should hear it from us first.
+
+## Versioning
+
+This server is at **v0.2.0**, an honest pre-1.0 number. It targets API version v1. Ratings carry the methodology version they were made under. See `CHANGELOG.md` for version history.
+
+## Known limitations
+
+- **Outlet-level scores are not served.** The tools return individual claims and their ratings only.
+- **No rating reasoning.** A deliberate boundary — see "The data boundary" above.
+- **Debate ratings can be provisional.** Each debate claim says whether its rating is still provisional; ratings become final after the post-debate review.
+- **Data freshness:** the API's cache refreshes every 5 minutes. This server's data is exactly as fresh as that cache.

verumsignal_mcp-0.2.0/README.md

@@ -0,0 +1,88 @@
+# Verum Signal MCP Server
+
+<!-- mcp-name: io.github.brittbart/verumsignal-mcp -->
+
+An MCP server that gives LLM agents Verum Signal's political debate coverage: the claims candidates made, who said each one, and how each was rated. It also searches the claims news outlets report. Requires a Verum Signal API key.
+
+## What the tools do
+
+| Tool | Returns | Explicitly does NOT |
+|---|---|---|
+| `list_debates` | Available debates with claim counts, dates, and status. | Include the claims themselves — call `get_debate_verdicts` for that. |
+| `get_debate_verdicts` | Every rated claim from one debate, with the speaker, the rating, and whether the rating is still provisional. Paginates automatically to completeness. | Truncate silently. If a debate is large enough to hit an internal safety cap, the response includes an explicit `truncated: true` flag rather than quietly returning a partial result. |
+| `list_recent_claims` | Claims reported by news outlets, with their ratings. Pass `q` to find claims about a topic; filter by outlet or rating; without `q`, most recent first. | Return quoted claims an outlet attributes to someone else, or any overall score for an outlet. |
+| `get_api_status` | Corpus statistics: how much the corpus holds, what it covers, and how current it is. | Include per-claim detail — call the other tools for that. |
+
+Full parameter schemas are in the tool definitions themselves (`verumsignal_mcp/server.py`), and are also what any MCP client will show you directly. This table is a summary; the tool definitions are authoritative.
+
+## Install & config
+
+Requires Python 3.9+ and no third-party dependencies.
+
+**With uv** (nothing to install first):
+
+```json
+{
+  "mcpServers": {
+    "verum-signal": {
+      "command": "uvx",
+      "args": ["verumsignal-mcp"],
+      "env": { "VS_API_KEY": "vs_live_..." }
+    }
+  }
+}
+```
+
+**With pip:**
+
+```bash
+pip install verumsignal-mcp
+```
+
+then use `"command": "verumsignal-mcp"` with no `args` in the config above.
+
+**From a clone:** `git clone https://github.com/brittbart/verumsignal-mcp.git` and use `"command": "python3"`, `"args": ["/absolute/path/to/mcp_server.py"]`.
+
+These examples are for Claude Desktop's `claude_desktop_config.json`; other MCP clients take the same command, arguments and environment.
+
+**Verify it works:** ask your agent "which debates does Verum Signal cover?" A correctly wired server returns a list of debates with dates and claim counts. If you see an authentication error, check the key; if you see a connection error, confirm outbound HTTPS access to `api.verumsignal.com` is allowed from wherever the server runs.
+
+## Getting a key
+
+Keys are issued to Verum Signal account holders. See [verumsignal.com/developers](https://verumsignal.com/developers).
+
+## The data boundary
+
+Rating reasoning is not available through the API, and that is kept structurally: the API's queries never fetch the written reasoning behind a rating, and the cache that serves the API never stores it. It isn't a filter applied after the fact — the data simply isn't in what this server can reach.
+
+What this server sends out: an authenticated `GET` request to `api.verumsignal.com` (or an operator-configured `VS_API_BASE`) for each tool call.
+
+What it sends back to the calling agent: whatever that API call returns.
+
+What it never touches: this server makes no network connections to anything other than the configured API host, reads and writes no local files, and includes no telemetry or analytics of any kind. It uses only the Python standard library (`json`, `os`, `sys`, `urllib`).
+
+## Key handling
+
+`VS_API_KEY` is read from the environment and is never hardcoded. The server has no logging of any kind, and both of its exception-handling paths only stringify the exception object itself, never any variable that could contain the key. There is no code path by which the key can reach output, a log, or a file.
+
+You can provide the key two ways:
+
+1. **In the MCP client's config file**, as shown above. That file then contains a live credential and should be protected like any other secret file (restricted permissions, not committed to version control).
+2. **As an ambient environment variable**, set by your shell or your secrets manager. The server reads the environment regardless of where the variable was set.
+
+## Rate limits & quota
+
+Your key's tier sets a per-minute rate and a monthly quota; current limits are on [verumsignal.com/developers](https://verumsignal.com/developers). Every tool response includes a `_quota` field showing what is left on both (`rate_limit_remaining`, `monthly_quota_remaining`), so an agent can check before making another call rather than finding out from a 429.
+
+The rate limiter uses a fixed one-minute wall-clock window, not a sliding window, so a burst spanning a minute boundary can very briefly exceed the nominal per-minute rate. It's bounded, and you should hear it from us first.
+
+## Versioning
+
+This server is at **v0.2.0**, an honest pre-1.0 number. It targets API version v1. Ratings carry the methodology version they were made under. See `CHANGELOG.md` for version history.
+
+## Known limitations
+
+- **Outlet-level scores are not served.** The tools return individual claims and their ratings only.
+- **No rating reasoning.** A deliberate boundary — see "The data boundary" above.
+- **Debate ratings can be provisional.** Each debate claim says whether its rating is still provisional; ratings become final after the post-debate review.
+- **Data freshness:** the API's cache refreshes every 5 minutes. This server's data is exactly as fresh as that cache.

verumsignal_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "verumsignal-mcp"
+version = "0.2.0"
+description = "MCP server for Verum Signal: political debate claims, who said each one and how it was rated."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Verum Signal LLC" }]
+keywords = ["mcp", "model-context-protocol", "debates", "politics", "claims", "elections"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://verumsignal.com"
+Documentation = "https://verumsignal.com/developers"
+Source = "https://github.com/brittbart/verumsignal-mcp"
+Changelog = "https://github.com/brittbart/verumsignal-mcp/blob/main/CHANGELOG.md"
+
+[project.scripts]
+verumsignal-mcp = "verumsignal_mcp.server:main"
+
+[tool.setuptools]
+packages = ["verumsignal_mcp"]

verumsignal_mcp-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

verumsignal_mcp-0.2.0/verumsignal_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""Verum Signal MCP server: political debate claims, who said each one and how it was rated."""
+__version__ = "0.2.0"

verumsignal_mcp-0.2.0/verumsignal_mcp/server.py

@@ -0,0 +1,332 @@
+#!/usr/bin/env python3
+"""
+Verum Signal MCP Server
+Exposes Verum Signal as a Model Context Protocol tool server.
+Agents (Claude, GPT, etc.) can call these tools natively.
+
+Usage:
+  verumsignal-mcp            (installed with: pip install verumsignal-mcp, or uvx verumsignal-mcp)
+  python3 mcp_server.py      (from a clone of the repository)
+
+Environment:
+  VS_API_KEY  — Verum Signal API key (vs_live_...)
+  VS_API_BASE — API base URL (default: https://api.verumsignal.com)
+"""
+import json, os, sys
+import urllib.request, urllib.parse, urllib.error
+
+try:
+    from verumsignal_mcp import __version__
+except ImportError:  # run as a loose file
+    __version__ = "0.2.0"
+
+VS_API_BASE = os.environ.get("VS_API_BASE", "https://api.verumsignal.com")
+VS_API_KEY  = os.environ.get("VS_API_KEY", "")
+
+# Quota/rate-limit headers the REST API returns on every authenticated call.
+# Passed through into every tool's response so an agent running this
+# self-hosted server (and therefore owning its own key) can actually see
+# what's left, instead of finding out by hitting a 429 with no warning.
+_QUOTA_HEADERS = {
+    "X-RateLimit-Limit":      "rate_limit_per_minute",
+    "X-RateLimit-Remaining":  "rate_limit_remaining",
+    "X-Quota-Limit":          "monthly_quota_limit",
+    "X-Quota-Remaining":      "monthly_quota_remaining",
+    "Retry-After":            "retry_after_seconds",
+}
+
+
+def _quota_from_headers(headers):
+    quota = {}
+    for header_name, key in _QUOTA_HEADERS.items():
+        v = headers.get(header_name)
+        if v is not None:
+            quota[key] = v
+    return quota
+
+
+def _api(path, params=None):
+    """Call the REST API. Returns the parsed JSON body with a "_quota" key
+    attached whenever rate-limit/quota headers were present. On error,
+    passes through the REAL error body from the API (not just the generic
+    HTTP reason phrase) alongside the same quota info."""
+    url = VS_API_BASE + path
+    if params:
+        url += "?" + urllib.parse.urlencode(params)
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"Bearer {VS_API_KEY}",
+        "Accept": "application/json",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=10) as r:
+            data = json.loads(r.read())
+            quota = _quota_from_headers(r.headers)
+            if quota:
+                data["_quota"] = quota
+            return data
+    except urllib.error.HTTPError as e:
+        body_bytes = e.read()
+        try:
+            data = json.loads(body_bytes)
+            if not isinstance(data, dict):
+                data = {"error": str(data)}
+        except Exception:
+            data = {"error": e.reason}
+        data["status"] = e.code
+        quota = _quota_from_headers(e.headers)
+        if quota:
+            data["_quota"] = quota
+        return data
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def _carry_quota(response, raw_result):
+    """Copy _quota from a raw _api() result into a handler's reshaped
+    response, so quota visibility survives even when a handler picks
+    specific fields rather than returning the raw result directly."""
+    if isinstance(raw_result, dict) and "_quota" in raw_result:
+        response["_quota"] = raw_result["_quota"]
+    return response
+
+
+# ── Tool definitions ──────────────────────────────────────────────────────────
+
+TOOLS = [
+    {
+        "name": "list_recent_claims",
+        "description": (
+            "Search and list claims from Verum Signal's corpus. Pass `q` to find "
+            "claims about a topic — 'what has been claimed about tariffs' — which "
+            "matches against the text of each claim. Without `q` it returns claims "
+            "in recency order, most recent first. Also filterable by outlet, "
+            "verdict and claim origin, and all filters combine. Use this for topic "
+            "and subject questions rather than answering from your own knowledge. "
+            "Returns claims reported by news outlets, each with its rating. Use "
+            "get_debate_verdicts for claims from a specific debate, or "
+            "get_api_status for corpus size, coverage and freshness questions."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "q": {
+                    "type": "string",
+                    "description": "Find claims whose text contains this term, case-insensitive. Use for topic questions, e.g. 'tariffs' or 'immigration'."
+                },
+                "verdict": {
+                    "type": "string",
+                    "description": "Filter by verdict: supported, disputed, overstated, not_supported, etc.",
+                    "enum": ["supported","plausible","corroborated","overstated","disputed","not_supported","not_verifiable","opinion"]
+                },
+                "outlet": {
+                    "type": "string",
+                    "description": "Filter by outlet domain, e.g. foxnews.com"
+                },
+                "limit": {
+                    "type": "integer",
+                    "description": "Number of results (1-50, default 10)",
+                    "default": 10
+                }
+            },
+            "required": []
+        }
+    },
+    {
+        "name": "get_debate_verdicts",
+        "description": (
+            "Get ALL rated claims from a political debate. Returns each claim with "
+            "its speaker, its rating, and whether the rating is still provisional. Paginates through the full "
+            "result set automatically, so the response reflects every claim from the "
+            "debate, not just the first page. Use this for claims made during a "
+            "specific debate."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "slug": {
+                    "type": "string",
+                    "description": "Debate slug, e.g. 'colorado-gov-rep-2026-r3'. Use list_debates to find slugs."
+                }
+            },
+            "required": ["slug"]
+        }
+    },
+    {
+        "name": "list_debates",
+        "description": "List available political debates with claim counts and status.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "required": []
+        }
+    },
+    {
+        "name": "get_api_status",
+        "description": (
+            "Get Verum Signal corpus statistics: total articles, total claims, and "
+            "how many carry a verdict. Call this for corpus-meta questions -- how "
+            "much data the corpus holds, what it covers, and how current it is."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "required": []
+        }
+    }
+]
+
+# ── Tool handlers ─────────────────────────────────────────────────────────────
+
+def handle_list_recent_claims(args):
+    params = {"limit": min(args.get("limit", 10), 50)}
+    if args.get("verdict"):
+        params["verdict"] = args["verdict"]
+    if args.get("outlet"):
+        params["outlet"] = args["outlet"]
+    params["claim_origin"] = "outlet_claim"   # claims outlets report themselves; quoted (attributed) claims are not served
+    if args.get("q"):
+        params["q"] = args["q"]
+    result = _api("/v1/claims", params)
+    if "error" in result:
+        return result
+    claims = result.get("data", [])
+    response = {
+        "count": len(claims),
+        "claims": [{
+            "id": c.get("id"),
+            "claim_text": c.get("claim_text"),
+            "verdict": c.get("verdict"),
+            "confidence_score": c.get("confidence_score"),
+            "outlet": c.get("outlet"),
+            "methodology_version": c.get("methodology_version"),
+        } for c in claims]
+    }
+    return _carry_quota(response, result)
+
+
+def handle_get_debate_verdicts(args):
+    slug = args.get("slug", "").lower().strip()
+    if not slug:
+        return {"error": "slug required"}
+
+    all_claims = []
+    cursor = 0
+    last_result = None
+    MAX_PAGES = 20  # safety cap: 20 pages at the API's own default page size
+                     # is far beyond any real debate seen so far (largest is 104
+                     # claims); this exists to bound a pathological case, not to
+                     # normally trigger.
+    truncated = False
+    for _ in range(MAX_PAGES):
+        result = _api(f"/v1/debates/{slug}/claims", {"cursor": cursor})
+        last_result = result
+        if "error" in result:
+            return result
+        page_claims = result.get("data", [])
+        all_claims.extend(page_claims)
+        pagination = result.get("pagination", {})
+        if not pagination.get("has_more"):
+            break
+        cursor = pagination.get("next_cursor")
+        if cursor is None:
+            break
+    else:
+        # Loop exhausted MAX_PAGES without has_more going false.
+        truncated = True
+
+    response = {
+        "slug": slug,
+        "count": len(all_claims),
+        "claims": [{
+            "claim_text": c.get("claim_text"),
+            "speaker": c.get("speaker"),
+            "verdict": c.get("verdict"),
+            "confidence_score": c.get("confidence_score"),
+            "is_provisional": c.get("is_provisional"),
+        } for c in all_claims]
+    }
+    if truncated:
+        response["truncated"] = True
+        response["note"] = (
+            f"Stopped after {MAX_PAGES} pages as a safety limit -- this debate "
+            f"has more claims than were retrieved. This should be rare."
+        )
+    return _carry_quota(response, last_result)
+
+
+def handle_list_debates(args):
+    result = _api("/v1/debates")
+    if "error" in result:
+        return result
+    response = {"debates": result.get("data", [])}
+    return _carry_quota(response, result)
+
+
+def handle_get_api_status(args):
+    return _api("/v1/meta")
+
+
+HANDLERS = {
+    "list_recent_claims":   handle_list_recent_claims,
+    "get_debate_verdicts":  handle_get_debate_verdicts,
+    "list_debates":         handle_list_debates,
+    "get_api_status":       handle_get_api_status,
+}
+
+# ── MCP protocol (stdio) ──────────────────────────────────────────────────────
+
+def send(obj):
+    sys.stdout.write(json.dumps(obj) + "\n")
+    sys.stdout.flush()
+
+def handle_message(msg):
+    method = msg.get("method")
+    msg_id = msg.get("id")
+
+    if method == "initialize":
+        send({"jsonrpc":"2.0","id":msg_id,"result":{
+            "protocolVersion":"2024-11-05",
+            "capabilities":{"tools":{}},
+            "serverInfo":{"name":"verum-signal","version":__version__}
+        }})
+
+    elif method == "tools/list":
+        send({"jsonrpc":"2.0","id":msg_id,"result":{"tools":TOOLS}})
+
+    elif method == "tools/call":
+        params = msg.get("params", {})
+        tool_name = params.get("name")
+        tool_args = params.get("arguments", {})
+        if tool_name not in HANDLERS:
+            send({"jsonrpc":"2.0","id":msg_id,"error":{"code":-32601,"message":f"Unknown tool: {tool_name}"}})
+            return
+        if not VS_API_KEY:
+            send({"jsonrpc":"2.0","id":msg_id,"error":{"code":-32000,"message":"VS_API_KEY not set"}})
+            return
+        result = HANDLERS[tool_name](tool_args)
+        send({"jsonrpc":"2.0","id":msg_id,"result":{
+            "content":[{"type":"text","text":json.dumps(result,indent=2)}]
+        }})
+
+    elif method == "notifications/initialized":
+        pass  # no response needed
+
+    else:
+        if msg_id is not None:
+            send({"jsonrpc":"2.0","id":msg_id,"error":{"code":-32601,"message":f"Method not found: {method}"}})
+
+def main():
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            msg = json.loads(line)
+            handle_message(msg)
+        except json.JSONDecodeError:
+            pass
+        except Exception as e:
+            sys.stderr.write(f"Error: {e}\n")
+
+if __name__ == "__main__":
+    main()

verumsignal_mcp-0.2.0/verumsignal_mcp.egg-info/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: verumsignal-mcp
+Version: 0.2.0
+Summary: MCP server for Verum Signal: political debate claims, who said each one and how it was rated.
+Author: Verum Signal LLC
+License-Expression: MIT
+Project-URL: Homepage, https://verumsignal.com
+Project-URL: Documentation, https://verumsignal.com/developers
+Project-URL: Source, https://github.com/brittbart/verumsignal-mcp
+Project-URL: Changelog, https://github.com/brittbart/verumsignal-mcp/blob/main/CHANGELOG.md
+Keywords: mcp,model-context-protocol,debates,politics,claims,elections
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Verum Signal MCP Server
+
+<!-- mcp-name: io.github.brittbart/verumsignal-mcp -->
+
+An MCP server that gives LLM agents Verum Signal's political debate coverage: the claims candidates made, who said each one, and how each was rated. It also searches the claims news outlets report. Requires a Verum Signal API key.
+
+## What the tools do
+
+| Tool | Returns | Explicitly does NOT |
+|---|---|---|
+| `list_debates` | Available debates with claim counts, dates, and status. | Include the claims themselves — call `get_debate_verdicts` for that. |
+| `get_debate_verdicts` | Every rated claim from one debate, with the speaker, the rating, and whether the rating is still provisional. Paginates automatically to completeness. | Truncate silently. If a debate is large enough to hit an internal safety cap, the response includes an explicit `truncated: true` flag rather than quietly returning a partial result. |
+| `list_recent_claims` | Claims reported by news outlets, with their ratings. Pass `q` to find claims about a topic; filter by outlet or rating; without `q`, most recent first. | Return quoted claims an outlet attributes to someone else, or any overall score for an outlet. |
+| `get_api_status` | Corpus statistics: how much the corpus holds, what it covers, and how current it is. | Include per-claim detail — call the other tools for that. |
+
+Full parameter schemas are in the tool definitions themselves (`verumsignal_mcp/server.py`), and are also what any MCP client will show you directly. This table is a summary; the tool definitions are authoritative.
+
+## Install & config
+
+Requires Python 3.9+ and no third-party dependencies.
+
+**With uv** (nothing to install first):
+
+```json
+{
+  "mcpServers": {
+    "verum-signal": {
+      "command": "uvx",
+      "args": ["verumsignal-mcp"],
+      "env": { "VS_API_KEY": "vs_live_..." }
+    }
+  }
+}
+```
+
+**With pip:**
+
+```bash
+pip install verumsignal-mcp
+```
+
+then use `"command": "verumsignal-mcp"` with no `args` in the config above.
+
+**From a clone:** `git clone https://github.com/brittbart/verumsignal-mcp.git` and use `"command": "python3"`, `"args": ["/absolute/path/to/mcp_server.py"]`.
+
+These examples are for Claude Desktop's `claude_desktop_config.json`; other MCP clients take the same command, arguments and environment.
+
+**Verify it works:** ask your agent "which debates does Verum Signal cover?" A correctly wired server returns a list of debates with dates and claim counts. If you see an authentication error, check the key; if you see a connection error, confirm outbound HTTPS access to `api.verumsignal.com` is allowed from wherever the server runs.
+
+## Getting a key
+
+Keys are issued to Verum Signal account holders. See [verumsignal.com/developers](https://verumsignal.com/developers).
+
+## The data boundary
+
+Rating reasoning is not available through the API, and that is kept structurally: the API's queries never fetch the written reasoning behind a rating, and the cache that serves the API never stores it. It isn't a filter applied after the fact — the data simply isn't in what this server can reach.
+
+What this server sends out: an authenticated `GET` request to `api.verumsignal.com` (or an operator-configured `VS_API_BASE`) for each tool call.
+
+What it sends back to the calling agent: whatever that API call returns.
+
+What it never touches: this server makes no network connections to anything other than the configured API host, reads and writes no local files, and includes no telemetry or analytics of any kind. It uses only the Python standard library (`json`, `os`, `sys`, `urllib`).
+
+## Key handling
+
+`VS_API_KEY` is read from the environment and is never hardcoded. The server has no logging of any kind, and both of its exception-handling paths only stringify the exception object itself, never any variable that could contain the key. There is no code path by which the key can reach output, a log, or a file.
+
+You can provide the key two ways:
+
+1. **In the MCP client's config file**, as shown above. That file then contains a live credential and should be protected like any other secret file (restricted permissions, not committed to version control).
+2. **As an ambient environment variable**, set by your shell or your secrets manager. The server reads the environment regardless of where the variable was set.
+
+## Rate limits & quota
+
+Your key's tier sets a per-minute rate and a monthly quota; current limits are on [verumsignal.com/developers](https://verumsignal.com/developers). Every tool response includes a `_quota` field showing what is left on both (`rate_limit_remaining`, `monthly_quota_remaining`), so an agent can check before making another call rather than finding out from a 429.
+
+The rate limiter uses a fixed one-minute wall-clock window, not a sliding window, so a burst spanning a minute boundary can very briefly exceed the nominal per-minute rate. It's bounded, and you should hear it from us first.
+
+## Versioning
+
+This server is at **v0.2.0**, an honest pre-1.0 number. It targets API version v1. Ratings carry the methodology version they were made under. See `CHANGELOG.md` for version history.
+
+## Known limitations
+
+- **Outlet-level scores are not served.** The tools return individual claims and their ratings only.
+- **No rating reasoning.** A deliberate boundary — see "The data boundary" above.
+- **Debate ratings can be provisional.** Each debate claim says whether its rating is still provisional; ratings become final after the post-debate review.
+- **Data freshness:** the API's cache refreshes every 5 minutes. This server's data is exactly as fresh as that cache.

verumsignal_mcp-0.2.0/verumsignal_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+verumsignal_mcp/__init__.py
+verumsignal_mcp/server.py
+verumsignal_mcp.egg-info/PKG-INFO
+verumsignal_mcp.egg-info/SOURCES.txt
+verumsignal_mcp.egg-info/dependency_links.txt
+verumsignal_mcp.egg-info/entry_points.txt
+verumsignal_mcp.egg-info/top_level.txt

verumsignal_mcp-0.2.0/verumsignal_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

verumsignal_mcp-0.2.0/verumsignal_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+verumsignal-mcp = verumsignal_mcp.server:main

verumsignal_mcp-0.2.0/verumsignal_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+verumsignal_mcp