verify-api-mcp 0.1.0__tar.gz

verify_api_mcp-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+.DS_Store

verify_api_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mick Goodson
+
+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.

verify_api_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.5
+Name: verify-api-mcp
+Version: 0.1.0
+Summary: MCP server for Verify API -- evidence-backed citation and URL verification for agents.
+Project-URL: Homepage, https://goodsong.dev
+Project-URL: Repository, https://github.com/mgdsn/verify-api-mcp
+Author: Mick Goodson
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2
+Description-Content-Type: text/markdown
+
+# Verify API MCP Server
+
+MCP server for [Verify API](https://goodsong.dev): a pay-per-call verification
+service that gives agents a fast, structured, evidence-backed yes/no/unknown on
+claims they'd otherwise guess at.
+
+Stop your agent from citing things that don't exist. Two tools, one answer each,
+evidence attached.
+
+## Tools
+
+- **`verify_citation`** -- does a citation exist, is it retracted, and does the
+  given title/authors/year/journal match the canonical record? Checked against
+  Crossref (includes Retraction Watch data) with OpenAlex as a fallback.
+- **`verify_url`** -- does a URL resolve, what's the final status and redirect
+  chain, is it archived on the Wayback Machine, and (optionally) does expected
+  text appear on the page?
+
+Every response includes a `verdict` (`confirmed` / `contradicted` / `unknown`),
+the individual `checks` that were run, and `evidence` with source URLs so a
+human can verify the answer themselves. `unknown` is a valid, honest answer --
+this server never guesses to avoid it.
+
+## Install
+
+```bash
+pip install verify-api-mcp
+```
+
+## Configure
+
+Get a free API key (100 calls, no card required):
+
+```bash
+curl -X POST https://goodsong.dev/signup
+```
+
+Then add to your MCP client's config (e.g. `mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "verify-api": {
+      "command": "verify-api-mcp",
+      "env": {
+        "VERIFY_API_KEY": "vk_..."
+      }
+    }
+  }
+}
+```
+
+`VERIFY_API_URL` defaults to `https://goodsong.dev` and only needs to be set if
+you're pointing at a different deployment.
+
+## License
+
+MIT
+
+<!-- mcp-name: io.github.mgdsn/verify-api-mcp -->

verify_api_mcp-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Verify API MCP Server
+
+MCP server for [Verify API](https://goodsong.dev): a pay-per-call verification
+service that gives agents a fast, structured, evidence-backed yes/no/unknown on
+claims they'd otherwise guess at.
+
+Stop your agent from citing things that don't exist. Two tools, one answer each,
+evidence attached.
+
+## Tools
+
+- **`verify_citation`** -- does a citation exist, is it retracted, and does the
+  given title/authors/year/journal match the canonical record? Checked against
+  Crossref (includes Retraction Watch data) with OpenAlex as a fallback.
+- **`verify_url`** -- does a URL resolve, what's the final status and redirect
+  chain, is it archived on the Wayback Machine, and (optionally) does expected
+  text appear on the page?
+
+Every response includes a `verdict` (`confirmed` / `contradicted` / `unknown`),
+the individual `checks` that were run, and `evidence` with source URLs so a
+human can verify the answer themselves. `unknown` is a valid, honest answer --
+this server never guesses to avoid it.
+
+## Install
+
+```bash
+pip install verify-api-mcp
+```
+
+## Configure
+
+Get a free API key (100 calls, no card required):
+
+```bash
+curl -X POST https://goodsong.dev/signup
+```
+
+Then add to your MCP client's config (e.g. `mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "verify-api": {
+      "command": "verify-api-mcp",
+      "env": {
+        "VERIFY_API_KEY": "vk_..."
+      }
+    }
+  }
+}
+```
+
+`VERIFY_API_URL` defaults to `https://goodsong.dev` and only needs to be set if
+you're pointing at a different deployment.
+
+## License
+
+MIT
+
+<!-- mcp-name: io.github.mgdsn/verify-api-mcp -->

verify_api_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "verify-api-mcp"
+version = "0.1.0"
+description = "MCP server for Verify API -- evidence-backed citation and URL verification for agents."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Mick Goodson" }]
+dependencies = ["httpx>=0.27", "mcp>=1.2"]
+
+[project.urls]
+Homepage = "https://goodsong.dev"
+Repository = "https://github.com/mgdsn/verify-api-mcp"
+
+[project.scripts]
+verify-api-mcp = "verify_api_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/verify_api_mcp"]

verify_api_mcp-0.1.0/server.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mgdsn/verify-api-mcp",
+  "title": "Verify API",
+  "description": "Deterministic, evidence-backed verification for citations and URLs -- catches fabricated or retracted citations and dead/altered links before an agent repeats them.",
+  "repository": { "url": "https://github.com/mgdsn/verify-api-mcp", "source": "github" },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "verify-api-mcp",
+      "version": "0.1.0",
+      "transport": { "type": "stdio" },
+      "environmentVariables": [
+        {
+          "name": "VERIFY_API_KEY",
+          "description": "API key from POST /signup at https://goodsong.dev/signup",
+          "isRequired": true,
+          "isSecret": true,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}

verify_api_mcp-0.1.0/src/verify_api_mcp/config.py

@@ -0,0 +1,11 @@
+import os
+
+# The API key this server instance authenticates as -- issued via
+# https://goodsong.dev/signup (free tier) or a paid key. Set per MCP client
+# config, e.g. `"env": {"VERIFY_API_KEY": "vk_..."}` in the client's mcp.json.
+VERIFY_API_KEY = os.environ.get("VERIFY_API_KEY", "")
+
+# This server runs on the END USER's machine (installed from PyPI/an MCP
+# registry), not ours -- it has no access to our database or core code, so
+# it must call the hosted API over HTTP like any other API-key client would.
+VERIFY_API_URL = os.environ.get("VERIFY_API_URL", "https://goodsong.dev")

verify_api_mcp-0.1.0/src/verify_api_mcp/server.py

@@ -0,0 +1,97 @@
+"""MCP server: exposes verify_citation and verify_url as tools.
+
+A thin HTTP client against the hosted Verify API at https://goodsong.dev,
+authenticated the same way any other API-key caller is
+(Authorization: Bearer <key>). Has no access to the API's database or core
+verification code -- it just calls the public endpoints.
+"""
+
+import httpx
+from mcp.server.mcpserver import MCPServer
+from mcp.server.mcpserver.exceptions import ToolError
+
+from verify_api_mcp.config import VERIFY_API_KEY, VERIFY_API_URL
+
+server = MCPServer(
+    name="verify-api",
+    title="Verify API",
+    description=(
+        "Deterministic, evidence-backed verification for citations and URLs -- "
+        "catches fabricated or retracted citations and dead/altered links before "
+        "an agent repeats them."
+    ),
+)
+
+
+async def _call_api(path: str, payload: dict) -> dict:
+    if not VERIFY_API_KEY:
+        raise ToolError(
+            "No API key configured for this MCP server. Set VERIFY_API_KEY in the "
+            "client's MCP config to a key from POST /signup at https://goodsong.dev/signup."
+        )
+    body = {k: v for k, v in payload.items() if v is not None}
+    try:
+        async with httpx.AsyncClient(timeout=20.0) as client:
+            resp = await client.post(
+                f"{VERIFY_API_URL}{path}",
+                json=body,
+                headers={"Authorization": f"Bearer {VERIFY_API_KEY}"},
+            )
+    except httpx.RequestError as e:
+        raise ToolError(f"Could not reach the Verify API at {VERIFY_API_URL}: {e}") from e
+
+    if resp.status_code == 401:
+        raise ToolError("VERIFY_API_KEY is invalid or revoked.")
+    if resp.status_code == 402:
+        detail = resp.json().get("error", {}).get("message", "Monthly call quota exceeded.")
+        raise ToolError(detail)
+    if resp.status_code >= 400:
+        raise ToolError(f"Verify API returned {resp.status_code}: {resp.text[:200]}")
+    return resp.json()
+
+
+@server.tool(
+    description=(
+        "Verify a citation: does it exist, is it retracted, and do the given title/"
+        "authors/year/journal match the canonical record? Checked against Crossref "
+        "(includes Retraction Watch data) with OpenAlex as a fallback when no DOI "
+        "is given. Provide a doi and/or a title."
+    )
+)
+async def verify_citation(
+    doi: str | None = None,
+    title: str | None = None,
+    authors: list[str] | None = None,
+    year: int | None = None,
+    journal: str | None = None,
+) -> dict:
+    return await _call_api(
+        "/verify/citation",
+        {"doi": doi, "title": title, "authors": authors, "year": year, "journal": journal},
+    )
+
+
+@server.tool(
+    description=(
+        "Verify a URL: does it resolve, what's the final status and redirect chain, "
+        "is it archived on the Wayback Machine, and (optionally) does expected text "
+        "appear on the page. Checked via direct fetch and the Internet Archive."
+    )
+)
+async def verify_url(
+    url: str,
+    expected_content: str | None = None,
+    expected_date: str | None = None,
+) -> dict:
+    return await _call_api(
+        "/verify/url",
+        {"url": url, "expected_content": expected_content, "expected_date": expected_date},
+    )
+
+
+def main() -> None:
+    server.run()
+
+
+if __name__ == "__main__":
+    main()