epitaxy-mcp 0.1.0__tar.gz

epitaxy_mcp-0.1.0/LICENSE

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

epitaxy_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: epitaxy-mcp
+Version: 0.1.0
+Summary: MCP server for federal drug shortages and recalls joined to federal drug contracts
+Author: epitaxy
+License: MIT
+Project-URL: Homepage, https://docs.crossgrain.xyz
+Project-URL: Source, https://github.com/vor-bot/epitaxy
+Project-URL: API, https://drugs.crossgrain.xyz/openapi.json
+Keywords: mcp,model-context-protocol,fda,drug-shortage,recall,usaspending,federal-contracts,procurement,open-data
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# epitaxy
+
+mcp-name: xyz.crossgrain/epitaxy
+
+Federal drug shortages and recalls, joined to the federal contracts that
+buy those drugs. One call, no signup.
+
+**What it claims:** this government supplier has an active FDA shortage
+or recall. **What it does not claim:** that a specific contract supplies
+a specific drug. Federal contract descriptions average 47 characters and
+almost never name the drug, so we say so instead of pretending otherwise.
+
+## Try it now, no key
+
+```bash
+curl https://drugs.crossgrain.xyz/v1/exposure?limit=5
+```
+
+## MCP
+
+Remote, nothing to install:
+
+```json
+{ "mcpServers": { "epitaxy": { "url": "https://drugs.crossgrain.xyz/v1/mcp" } } }
+```
+
+Local, stdio:
+
+```json
+{ "mcpServers": { "epitaxy": { "command": "uvx", "args": ["epitaxy-mcp"] } } }
+```
+
+Tools: `get_data_freshness`, `list_drug_shortages`, `list_drug_recalls`,
+`list_federal_drug_contracts`, `get_supplier_exposure`.
+
+## Read the confidence field, always
+
+| value | meaning |
+| --- | --- |
+| `exact` | match on a shared identifier, here an NDC inside FDA data |
+| `probable` | normalized company name, or a drug name token in the contract text |
+| `weak` | anything softer, an indication only |
+
+Matching on both company and drug at once is **not** promoted to
+`exact`. Cross source joins are never `exact`, because FDA and
+USAspending share no identifier. Anyone claiming otherwise has a
+different source or is guessing.
+
+## Free tier
+
+Works forever, no key, no signup. Returns at most 20 rows, without the
+`evidence` field, without `weak` matches, and with data delayed by 24
+hours. Nothing is stored: no counters, no IP addresses.
+
+## Paid
+
+| plan | price | contents |
+| --- | --- | --- |
+| Starter | 29 USD/mo | 10 000 calls |
+| Pro | 99 USD/mo | 100 000 calls plus daily delta feed |
+| x402 | 0.004 USD/call | USDC on Base, no signup |
+| Bulk dump | 199 USD | one off, Stripe only |
+
+## Sources and licence
+
+- openFDA, public domain, CC0 1.0 Universal
+- USAspending, public domain, code under CC0
+
+Data is unvalidated and must not be used for medical decisions.
+This project is MIT licensed. Docs: https://docs.crossgrain.xyz

epitaxy_mcp-0.1.0/README.md

@@ -0,0 +1,70 @@
+# epitaxy
+
+mcp-name: xyz.crossgrain/epitaxy
+
+Federal drug shortages and recalls, joined to the federal contracts that
+buy those drugs. One call, no signup.
+
+**What it claims:** this government supplier has an active FDA shortage
+or recall. **What it does not claim:** that a specific contract supplies
+a specific drug. Federal contract descriptions average 47 characters and
+almost never name the drug, so we say so instead of pretending otherwise.
+
+## Try it now, no key
+
+```bash
+curl https://drugs.crossgrain.xyz/v1/exposure?limit=5
+```
+
+## MCP
+
+Remote, nothing to install:
+
+```json
+{ "mcpServers": { "epitaxy": { "url": "https://drugs.crossgrain.xyz/v1/mcp" } } }
+```
+
+Local, stdio:
+
+```json
+{ "mcpServers": { "epitaxy": { "command": "uvx", "args": ["epitaxy-mcp"] } } }
+```
+
+Tools: `get_data_freshness`, `list_drug_shortages`, `list_drug_recalls`,
+`list_federal_drug_contracts`, `get_supplier_exposure`.
+
+## Read the confidence field, always
+
+| value | meaning |
+| --- | --- |
+| `exact` | match on a shared identifier, here an NDC inside FDA data |
+| `probable` | normalized company name, or a drug name token in the contract text |
+| `weak` | anything softer, an indication only |
+
+Matching on both company and drug at once is **not** promoted to
+`exact`. Cross source joins are never `exact`, because FDA and
+USAspending share no identifier. Anyone claiming otherwise has a
+different source or is guessing.
+
+## Free tier
+
+Works forever, no key, no signup. Returns at most 20 rows, without the
+`evidence` field, without `weak` matches, and with data delayed by 24
+hours. Nothing is stored: no counters, no IP addresses.
+
+## Paid
+
+| plan | price | contents |
+| --- | --- | --- |
+| Starter | 29 USD/mo | 10 000 calls |
+| Pro | 99 USD/mo | 100 000 calls plus daily delta feed |
+| x402 | 0.004 USD/call | USDC on Base, no signup |
+| Bulk dump | 199 USD | one off, Stripe only |
+
+## Sources and licence
+
+- openFDA, public domain, CC0 1.0 Universal
+- USAspending, public domain, code under CC0
+
+Data is unvalidated and must not be used for medical decisions.
+This project is MIT licensed. Docs: https://docs.crossgrain.xyz

epitaxy_mcp-0.1.0/epitaxy_mcp.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: epitaxy-mcp
+Version: 0.1.0
+Summary: MCP server for federal drug shortages and recalls joined to federal drug contracts
+Author: epitaxy
+License: MIT
+Project-URL: Homepage, https://docs.crossgrain.xyz
+Project-URL: Source, https://github.com/vor-bot/epitaxy
+Project-URL: API, https://drugs.crossgrain.xyz/openapi.json
+Keywords: mcp,model-context-protocol,fda,drug-shortage,recall,usaspending,federal-contracts,procurement,open-data
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# epitaxy
+
+mcp-name: xyz.crossgrain/epitaxy
+
+Federal drug shortages and recalls, joined to the federal contracts that
+buy those drugs. One call, no signup.
+
+**What it claims:** this government supplier has an active FDA shortage
+or recall. **What it does not claim:** that a specific contract supplies
+a specific drug. Federal contract descriptions average 47 characters and
+almost never name the drug, so we say so instead of pretending otherwise.
+
+## Try it now, no key
+
+```bash
+curl https://drugs.crossgrain.xyz/v1/exposure?limit=5
+```
+
+## MCP
+
+Remote, nothing to install:
+
+```json
+{ "mcpServers": { "epitaxy": { "url": "https://drugs.crossgrain.xyz/v1/mcp" } } }
+```
+
+Local, stdio:
+
+```json
+{ "mcpServers": { "epitaxy": { "command": "uvx", "args": ["epitaxy-mcp"] } } }
+```
+
+Tools: `get_data_freshness`, `list_drug_shortages`, `list_drug_recalls`,
+`list_federal_drug_contracts`, `get_supplier_exposure`.
+
+## Read the confidence field, always
+
+| value | meaning |
+| --- | --- |
+| `exact` | match on a shared identifier, here an NDC inside FDA data |
+| `probable` | normalized company name, or a drug name token in the contract text |
+| `weak` | anything softer, an indication only |
+
+Matching on both company and drug at once is **not** promoted to
+`exact`. Cross source joins are never `exact`, because FDA and
+USAspending share no identifier. Anyone claiming otherwise has a
+different source or is guessing.
+
+## Free tier
+
+Works forever, no key, no signup. Returns at most 20 rows, without the
+`evidence` field, without `weak` matches, and with data delayed by 24
+hours. Nothing is stored: no counters, no IP addresses.
+
+## Paid
+
+| plan | price | contents |
+| --- | --- | --- |
+| Starter | 29 USD/mo | 10 000 calls |
+| Pro | 99 USD/mo | 100 000 calls plus daily delta feed |
+| x402 | 0.004 USD/call | USDC on Base, no signup |
+| Bulk dump | 199 USD | one off, Stripe only |
+
+## Sources and licence
+
+- openFDA, public domain, CC0 1.0 Universal
+- USAspending, public domain, code under CC0
+
+Data is unvalidated and must not be used for medical decisions.
+This project is MIT licensed. Docs: https://docs.crossgrain.xyz

epitaxy_mcp-0.1.0/epitaxy_mcp.egg-info/SOURCES.txt

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

epitaxy_mcp-0.1.0/epitaxy_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

epitaxy_mcp-0.1.0/epitaxy_mcp.egg-info/entry_points.txt

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

epitaxy_mcp-0.1.0/epitaxy_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+mcp_server

epitaxy_mcp-0.1.0/mcp_server/server.py

@@ -0,0 +1,186 @@
+"""MCP server nad epitaxy API. Stdio transport, len stdlib.
+
+Toto je zároveň distribučný kanál číslo 1 aj 2 z research/distribution.md:
+zápis do MCP registrov a vlastný open source klient. Balík sa spúšťa
+jedným príkazom a funguje bez kľúča, lebo bezplatná vrstva nepotrebuje
+registráciu.
+
+Spustenie:
+    python3 -m mcp_server.server
+
+Premenné:
+    EPITAXY_API_URL   základ API, predvolene https://api.crossgrain.xyz
+    EPITAXY_API_KEY   nepovinný, bez neho beží bezplatná vrstva
+"""
+
+import json
+import os
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+API_URL = os.environ.get("EPITAXY_API_URL", "https://api.crossgrain.xyz")
+API_KEY = os.environ.get("EPITAXY_API_KEY")
+USER_AGENT = "epitaxy-mcp/0.1"
+PROTOCOL_VERSION = "2025-06-18"
+
+TOOLS = [
+    {
+        "name": "get_data_freshness",
+        "description": ("Vrati cas poslednej aktivacie dat, pocet zivych "
+                        "segmentov a stav posledneho behu. Volaj to prve, "
+                        "ked chces vediet, ci su data cerstve."),
+        "inputSchema": {"type": "object", "properties": {}},
+    },
+    {
+        "name": "list_drug_shortages",
+        "description": ("Vypadky liekov podla FDA. Filtre: status, "
+                        "generic_name, company_id, limit."),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "status": {"type": "string"},
+                "generic_name": {"type": "string"},
+                "company_id": {"type": "string"},
+                "limit": {"type": "integer"},
+            },
+        },
+    },
+    {
+        "name": "list_drug_recalls",
+        "description": "Stiahnutia liekov podla FDA. Filtre: classification, company_id, limit.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "classification": {"type": "string"},
+                "company_id": {"type": "string"},
+                "limit": {"type": "integer"},
+            },
+        },
+    },
+    {
+        "name": "list_federal_drug_contracts",
+        "description": ("Federalne kontrakty na lieky, PSC 6505. "
+                        "Filtre: agency, company_id, limit."),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "agency": {"type": "string"},
+                "company_id": {"type": "string"},
+                "limit": {"type": "integer"},
+            },
+        },
+    },
+    {
+        "name": "get_supplier_exposure",
+        "description": (
+            "Spojenie kontraktu s vypadkom alebo stiahnutim. KAZDY riadok "
+            "nesie confidence exact, probable alebo weak a match_method. "
+            "Cross source spojenie NIKDY nie je exact, lebo medzi FDA a "
+            "USAspending neexistuje spolocny identifikator. Tvrdenie znie: "
+            "tento dodavatel vlady ma u FDA aktivny vypadok alebo "
+            "stiahnutie. NETVRDI, ze konkretny kontrakt dodava konkretny "
+            "liek. Bez kluca sa vracaju len exact a probable zhody, "
+            "najviac 20 riadkov, bez evidence."),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "award_id": {"type": "string"},
+                "company_id": {"type": "string"},
+                "min_confidence": {"type": "string",
+                                   "enum": ["probable", "weak"]},
+                "limit": {"type": "integer"},
+            },
+        },
+    },
+]
+
+TOOL_PATHS = {
+    "get_data_freshness": "/v1/meta",
+    "list_drug_shortages": "/v1/shortages",
+    "list_drug_recalls": "/v1/recalls",
+    "list_federal_drug_contracts": "/v1/contracts",
+    "get_supplier_exposure": "/v1/exposure",
+}
+
+
+def call_api(path, params):
+    query = urllib.parse.urlencode(
+        dict((k, v) for k, v in params.items() if v not in (None, "")))
+    url = "%s%s%s" % (API_URL, path, ("?" + query) if query else "")
+    headers = {"User-Agent": USER_AGENT, "Accept": "application/json"}
+    if API_KEY:
+        headers["X-API-Key"] = API_KEY
+    request = urllib.request.Request(url, headers=headers)
+    try:
+        with urllib.request.urlopen(request, timeout=30) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as exc:
+        body = exc.read().decode("utf-8", "replace")
+        try:
+            return json.loads(body)
+        except ValueError:
+            return {"error": "http_%d" % exc.code, "body": body[:500]}
+    except Exception as exc:
+        return {"error": "network", "message": str(exc)[:200]}
+
+
+def handle(message):
+    method = message.get("method")
+    request_id = message.get("id")
+
+    if method == "initialize":
+        return {
+            "jsonrpc": "2.0", "id": request_id,
+            "result": {
+                "protocolVersion": PROTOCOL_VERSION,
+                "capabilities": {"tools": {}},
+                "serverInfo": {"name": "epitaxy", "version": "0.1.0"},
+                "instructions": (
+                    "Data o vypadkoch a stiahnutiach liekov spojene s "
+                    "federalnymi kontraktmi. Vzdy citaj pole confidence."),
+            },
+        }
+    if method in ("notifications/initialized", "notifications/cancelled"):
+        return None
+    if method == "tools/list":
+        return {"jsonrpc": "2.0", "id": request_id, "result": {"tools": TOOLS}}
+    if method == "tools/call":
+        params = message.get("params", {})
+        name = params.get("name")
+        path = TOOL_PATHS.get(name)
+        if not path:
+            return {"jsonrpc": "2.0", "id": request_id,
+                    "error": {"code": -32601, "message": "neznamy nastroj"}}
+        result = call_api(path, params.get("arguments") or {})
+        return {
+            "jsonrpc": "2.0", "id": request_id,
+            "result": {
+                "content": [{"type": "text",
+                             "text": json.dumps(result, ensure_ascii=False)}],
+                "isError": bool(result.get("error")),
+            },
+        }
+    return {"jsonrpc": "2.0", "id": request_id,
+            "error": {"code": -32601, "message": "neznama metoda %s" % method}}
+
+
+def main(argv=None):
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            message = json.loads(line)
+        except ValueError:
+            continue
+        response = handle(message)
+        if response is not None:
+            sys.stdout.write(json.dumps(response, ensure_ascii=False) + "\n")
+            sys.stdout.flush()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

epitaxy_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "epitaxy-mcp"
+version = "0.1.0"
+description = "MCP server for federal drug shortages and recalls joined to federal drug contracts"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "epitaxy" }]
+keywords = [
+    "mcp", "model-context-protocol", "fda", "drug-shortage", "recall",
+    "usaspending", "federal-contracts", "procurement", "open-data",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://docs.crossgrain.xyz"
+Source = "https://github.com/vor-bot/epitaxy"
+API = "https://drugs.crossgrain.xyz/openapi.json"
+
+[project.scripts]
+epitaxy-mcp = "mcp_server.server:main"
+
+[tool.setuptools]
+packages = ["mcp_server"]

epitaxy_mcp-0.1.0/setup.cfg

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