{
  "markdown": "<!-- mcp-name: com.metricprovenance/odgs-mcp-server -->\n# Open Data Governance Standard (ODGS) — MCP Server\n\n> **Deterministic governance enforcement at the AI agent boundary.**\n\n[![Protocol](https://img.shields.io/badge/Protocol-v6.0.5_(Sovereign_Engine)-0055AA)](https://metricprovenance.com/pricing)\n[![MCP Server](https://img.shields.io/badge/MCP_Server-v0.3.4-blueviolet)](https://modelcontextprotocol.io/)\n[![PyPI Downloads](https://img.shields.io/pypi/dm/odgs-mcp-server?label=PyPI%20Downloads&color=blue)](https://pypistats.org/packages/odgs-mcp-server)\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/License-Apache_2.0-lightgrey)](LICENSE)\n\n---\n\n> **For engineers:** See [Quick Start](#quick-start) below, or the guided walkthrough at [metricprovenance.com/start](https://www.metricprovenance.com/start).  \n> **For compliance and risk officers:** The ODGS engine generates cryptographic audit trails (S-Certs).  \n> **For architectural clearance and certified packs:** [metricprovenance.com/pricing](https://metricprovenance.com/pricing)\n\n### See it in action\n\n[![Watch an AI agent run governance_score through this MCP server](docs/demo/clip_mcp_poster.jpg)](docs/demo/clip_mcp.mp4)\n\nEight DAMA DMBOK pillars scored in about ten minutes — real MCP server, real maturity engine, click to watch on GitHub.\n\n---\n\n> [!IMPORTANT]\n> **ODGS MCP Server v0.3.4 — Maturity Diagnostics + Certified Pack Access**\n> `governance_score` now delegates to the **`odgs-maturity`** 8-pillar DAMA DMBOK engine.\n> Regulatory compilation, drift detection, and catalog synchronisation require a Certified Pack licence.\n> The community tier — validation, scoring, conformance checking — remains open with no registration.\n\n---\n\n### Core Capabilities\n\n| Change | Detail |\n|---|---|\n| **`governance_score`** | Delegates to `odgs-maturity` (8-pillar DAMA DMBOK) when installed; falls back to built-in heuristic. Returns 0–100 score with per-pillar gap analysis. |\n| **AuthGate** | Community / Professional / Enterprise access via API key validation. 24h disk cache; `workspace.yaml` fallback for air-gapped deployments. |\n| **Licensed tools** | `compile_regulation`, `check_drift`, `detect_conflicts`, `narrate_audit`, `discover_bindings` (Professional); `harvest_sovereign_rules` (Enterprise). |\n\n> The European Data Governance Maturity Benchmark 2026 recorded an average maturity of **37.6%** across 99 enterprises — a **62.4% gap** against current regulatory expectation. `governance_score` applies the same assessment methodology to your project.\n\n---\n\n## What This Is\n\nThe ODGS MCP Server connects any MCP-compatible AI agent to the ODGS Sovereign Validation Engine. The engine evaluates data operations against governance rules at runtime and produces **S-Certs (Sovereign Certificates)** — cryptographically signed, machine-verifiable records that a governance rule was applied.\n\nThis is the bridge between probabilistic AI inference and deterministic governance enforcement.\n\n### EU AI Act & High-Risk AI Systems\n\nOrganisations operating High-Risk AI Systems under **EU AI Act Articles 10 and 12** require demonstrable, auditable data governance at the pipeline level. S-Certs provide that audit trail in a format suitable for regulatory submission.\n\nCertified Sovereign Packs and the S-Cert Registry are available through Metric Provenance certified implementation partners. For architectural assessment: [metricprovenance.com/pricing](https://metricprovenance.com/pricing).\n\n---\n\n## Capabilities\n\n- **Runtime validation:** Data payloads are evaluated against sovereign governance rules at call time; each evaluation produces a signed S-Cert.\n- **Governance maturity scoring:** 8-pillar DAMA DMBOK assessment (0–100) with per-pillar gap analysis, aligned to the European Governance Maturity Benchmark methodology.\n- **Regulatory compilation** *(licensed)*: Converts legislative text — EU AI Act, DORA, GDPR — into validated ODGS rule JSON.\n- **Semantic drift detection** *(licensed)*: Identifies definitional drift between governance artefacts across versions.\n- **Enterprise catalog integration** *(licensed)*: Harvests and mints sovereign rules from Databricks, Snowflake, and Collibra via the Flint Bridge.\n\n---\n\n## Quick Start\n\n```bash\n# Core validation capabilities (free, no account needed)\npip install odgs-mcp-server\n\n# With maturity scoring\npip install odgs-mcp-server odgs-maturity\n\n# Complete installation with LLM bridge capabilities\npip install \"odgs-mcp-server[llm]\"\n```\n\n### Client Configuration\n\nThe server operates over standard **stdio transport**, making it instantly compatible with any MCP client.\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\nAdd to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"odgs-governance\": {\n      \"command\": \"odgs-mcp-server\",\n      \"args\": [\"--transport\", \"stdio\"],\n      \"env\": {\n        \"ODGS_PROJECT_ROOT\": \"/path/to/your/odgs/project\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\nAdd to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"odgs-governance\": {\n      \"command\": \"odgs-mcp-server\",\n      \"args\": [\"--transport\", \"stdio\"],\n      \"env\": {\n        \"ODGS_PROJECT_ROOT\": \"/path/to/your/odgs/project\"\n      }\n    }\n  }\n}\n```\n</details>\n\n### Licensed Tool Access\n\nRegulatory compilation, certified packs, and catalog synchronisation require a Certified Pack licence. Provide the issued API key in your client configuration:\n\n```json\n\"env\": {\n  \"ODGS_API_KEY\": \"sk-odgs-...\",\n  \"ODGS_PROJECT_ROOT\": \"/path/to/your/odgs/project\"\n}\n```\n**Licences are self-serve** — buy at [metricprovenance.com/pricing](https://metricprovenance.com/pricing) and your key is emailed on purchase:\n\n| Tier | Price | Includes |\n|:---|:---|:---|\n| **Community** | Free | `validate_payload`, `governance_score`, `list_packs`, `conformance_check` — no registration |\n| **Team** | €990/yr | One certified regulation pack, signed + updated, plus all Professional tools |\n| **Professional** | €2,490/yr | All certified packs, priority re-signing on regulatory change |\n| **Consultant** | €4,990/yr | Professional + white-label / client-deliverable rights |\n\n*Enterprise deployments (Sovereign CA nodes, `harvest_sovereign_rules`) via [certified partners](https://metricprovenance.com/pricing).*\n\n---\n\n## Tools Reference\n\n### Community (Free — no API key required)\n| Tool | Description |\n|:---|:---|\n| `validate_payload` | Validate data against ODGS governance rules, produce S-Cert |\n| `validate_batch` | Validate multiple payloads in one call |\n| `list_packs` | List available Certified Regulation Packs |\n| `governance_score` | Score governance maturity (0–100) across 8 DAMA pillars with gap analysis |\n| `conformance_check` | Run ODGS conformance self-check (L1/L2) |\n\n### Professional (API Key Required)\n| Tool | Description |\n|:---|:---|\n| `download_pack` | Download and cache certified regulatory rule packs locally |\n| `compile_regulation` | Convert regulation text → validated ODGS rule JSON |\n| `check_drift` | Detect semantic drift in governance definitions |\n| `detect_conflicts` | Find contradictions between regulatory rules |\n| `narrate_audit` | Convert S-Cert → human-readable narrative |\n| `discover_bindings` | Auto-generate physical data mappings from catalogs |\n\n### Enterprise (API Key Required)\n| Tool | Description |\n|:---|:---|\n| `harvest_sovereign_rules` | (Flint Bridge) Automatically extract and mint rules from data stores — **preview**, pending verification against the harvester interface |\n\n---\n\n## Architecture\n\nThe ODGS MCP Server is designed for **zero-trust, local-first execution**. All data validation happens strictly on your machine. No sensitive data leaves your perimeter.\n\n```mermaid\nflowchart TB\n    Agent[AI Agent\\nClaude/Cursor/Custom]\n    \n    subgraph \"ODGS MCP Server\"\n        Auth[AuthGate]\n        Val[OdgsInterceptor v6]\n        Maturity[odgs-maturity\\n8-pillar DAMA]\n        LLM[OdgsLlmBridge]\n        Flint[Flint Bridge]\n    end\n    \n    Reg[(S-Cert Registry\\nregistry.metricprovenance.com)]\n    Project[(Local ODGS Project)]\n\n    Agent -- \"JSON-RPC (stdio)\" --> Auth\n    Auth -- \"Validate Key (HTTPS, cached 24h)\" --> Reg\n    Auth --> Val\n    Auth --> Maturity\n    Auth --> LLM\n    Auth --> Flint\n    \n    Val -- \"Reads Rules\" --> Project\n    Val -- \"Generates\" --> SCert[S-Cert]\n    Maturity -- \"Scores pillars\" --> Project\n    LLM -- \"Compiles Regulations\" --> Project\n    Flint -- \"Harvests Sovereign Rules\" --> Project\n```\n\n---\n\n## Certified Regulation Packs\n\nCryptographically signed rule bundles, each mapped to a specific regulatory instrument. Packs are compiled from authoritative legislative text and certified by Metric Provenance.\n\n| Pack | Regulation | Status |\n|:---|:---|:---|\n| **EU AI Act** | Regulation (EU) 2024/1689 | ✅ Certified |\n| **DORA** | Digital Operational Resilience Act | ✅ Certified |\n| **GDPR** | General Data Protection Regulation | ✅ Certified |\n| **CSRD** | Corporate Sustainability Reporting Directive | ✅ Certified |\n| **NIS2** | Network and Information Security Directive | ✅ Certified |\n| **Basel III** | Basel Committee on Banking Supervision | ✅ Certified |\n\n*Full catalogue of 15+ packs. Licensing and deployment via [metricprovenance.com/pricing](https://metricprovenance.com/pricing).*\n\n---\n\n## Environment Variables\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `ODGS_PROJECT_ROOT` | Path to ODGS governance definitions | Current directory |\n| `ODGS_API_KEY` | API key for Professional/Enterprise access | None (community) |\n| `ODGS_REGISTRY_URL` | Registry endpoint for key validation | `https://registry.metricprovenance.com` |\n| `ODGS_CACHE_DIR` | Local cache for downloaded packs | `~/.odgs/cache` |\n\n---\n\n## About ODGS\n\nThe Open Data Governance Standard (ODGS) is an open protocol for deterministic data governance enforcement. ODGS is on a path toward formal standardization.\n\n- [Protocol specification](https://github.com/MetricProvenance/odgs) — `pip install odgs`\n- [PyPI package](https://pypi.org/project/odgs-mcp-server/)\n- [Research paper (SSRN 6205478)](https://papers.ssrn.com/abstract=6205478)\n- [Metric Provenance](https://metricprovenance.com/pricing)\n\n## Licence\n\nApache 2.0 — see [LICENSE](LICENSE).\n\nThe protocol engine and MCP server are open source. Certified Regulation Packs are issued under a commercial licence.\n\n",
  "bytes": 10422,
  "sha": "345d54340ecf984c0cd05fdeef9834f68daa153c35fa0e2fd63ee86472e0bb14",
  "repo_slug": "metricprovenance/odgs-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_metricprovenance_odgs_mcp_server_d3141bde/readme"
}