{"_id":"@api-common/api-governance-mcp","_rev":"2-81080f3e1e1dc164362624ae8e12290f","name":"@api-common/api-governance-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@api-common/api-governance-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","spectral","openapi","asyncapi","arazzo","apis.json","api-governance","linting"],"license":"Apache-2.0","_id":"@api-common/api-governance-mcp@1.0.0","maintainers":[{"name":"api-commons","email":"info@apicommons.org"}],"homepage":"https://apicommons.org/tools/","bugs":{"url":"https://github.com/api-commons/api-governance-mcp/issues"},"bin":{"api-governance-mcp":"src/server.mjs"},"dist":{"shasum":"d5f302d87aeb57bf893116b4afccb21ebdbe2935","tarball":"https://registry.npmjs.org/@api-common/api-governance-mcp/-/api-governance-mcp-1.0.0.tgz","fileCount":41,"integrity":"sha512-WwygVKKkg0U1ENbBVdz+P+ofnRt3TsJKKFe90WHyi9SobO69Z282IhPaxf5ZhbcV72oEM4Whv6KtSREvC5Q5Zg==","signatures":[{"sig":"MEUCIQCWgNMpCA+jog5HtbVQlT8gwu3et9LkGiDWGWgvjbBljQIgYhcEB/BmyIwScOcUWPeVUDs9YjaNGsgpH+5CmL7uGFA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1127689},"type":"module","gitHead":"abae2c75c9ceb106aa64ea6b2d12d4caf6741640","scripts":{"test":"node test/smoke.mjs","start":"node src/server.mjs"},"_npmUser":{"name":"api-commons","email":"info@apicommons.org"},"repository":{"url":"git+https://github.com/api-commons/api-governance-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"A Model Context Protocol (MCP) server that lints API artifacts (OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, MCP, …) against a best-of-breed API governance ruleset from any AI client. Powered by Spectral.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.8","yaml":"^2.6.1","@stoplight/spectral-core":"^1.19.0","@modelcontextprotocol/sdk":"^1.12.0","@stoplight/spectral-formats":"^1.7.0","@stoplight/spectral-parsers":"^1.0.4","@stoplight/spectral-rulesets":"^1.21.0","@stoplight/spectral-functions":"^1.9.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/api-governance-mcp_1.0.0_1783101609919_0.39501032854792584","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@api-common/api-governance-mcp","version":"1.1.0","description":"A Model Context Protocol (MCP) server that lints API artifacts (OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, MCP, …) against a best-of-breed API governance ruleset from any AI client. Powered by Spectral.","type":"module","bin":{"api-governance-mcp":"src/server.mjs"},"scripts":{"start":"node src/server.mjs","test":"node test/smoke.mjs"},"keywords":["mcp","model-context-protocol","spectral","openapi","asyncapi","arazzo","apis.json","api-governance","linting"],"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/api-commons/api-governance-mcp.git"},"homepage":"https://apicommons.org/tools/","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","@stoplight/spectral-core":"^1.19.0","@stoplight/spectral-formats":"^1.7.0","@stoplight/spectral-functions":"^1.9.0","@stoplight/spectral-parsers":"^1.0.4","@stoplight/spectral-rulesets":"^1.21.0","yaml":"^2.6.1","zod":"^3.23.8"},"gitHead":"76ea142afb113c6de4b9ae794e7079d95ce05604","_id":"@api-common/api-governance-mcp@1.1.0","bugs":{"url":"https://github.com/api-commons/api-governance-mcp/issues"},"_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-1zqFmoNJt05aNpCLj3iAb9jpuFpO2X5Rt5GVgi6yk8wDos0RSl7/DljlQQBpwjo7lScNvCEBf8d9+bqslufkfA==","shasum":"46f5ae188465a9f282dbb4b9b9e817066ea5abf0","tarball":"https://registry.npmjs.org/@api-common/api-governance-mcp/-/api-governance-mcp-1.1.0.tgz","fileCount":41,"unpackedSize":1181284,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEMCH3Op9M/qFSuiw0EtZIgtaigV2tjvzMIQDQUZxiTXdOMCIDhyDP3nZLHNH+BetstQBZhIdCZNVWZhZMX5rVaAEAGg"}]},"_npmUser":{"name":"api-commons","email":"info@apicommons.org"},"directories":{},"maintainers":[{"name":"api-commons","email":"info@apicommons.org"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/api-governance-mcp_1.1.0_1783117823403_0.8217725046246778"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-03T18:00:09.659Z","modified":"2026-07-03T22:30:23.670Z","1.0.0":"2026-07-03T18:00:10.079Z","1.1.0":"2026-07-03T22:30:23.550Z"},"bugs":{"url":"https://github.com/api-commons/api-governance-mcp/issues"},"license":"Apache-2.0","homepage":"https://apicommons.org/tools/","keywords":["mcp","model-context-protocol","spectral","openapi","asyncapi","arazzo","apis.json","api-governance","linting"],"repository":{"type":"git","url":"git+https://github.com/api-commons/api-governance-mcp.git"},"description":"A Model Context Protocol (MCP) server that lints API artifacts (OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, MCP, …) against a best-of-breed API governance ruleset from any AI client. Powered by Spectral.","maintainers":[{"name":"api-commons","email":"info@apicommons.org"}],"readme":"# API Governance MCP\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that lets **any AI\nclient** lint your API artifacts against a best-of-breed **API governance ruleset** —\nso an agent can check your OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, MCP, and\nmore, conversationally, and tell you what to fix.\n\nPowered by **[Spectral](https://github.com/stoplightio/spectral)**. It runs the same\nengine and the same compiled ruleset as the [API Commons **API\nValidator**](https://validator.apicommons.org) — the browser tool — here server-side\nover stdio. The ruleset is compiled from public Spectral rulesets and the\n[API Evangelist](https://apievangelist.com) governance rules: **733 rules across 12\nartifact formats**. Every rule ships at `info` to educate; raise individual rules to\n`warn`/`error` with a custom ruleset for what you choose to enforce.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `lint_artifact` | Lint an artifact (`content`, optional `format`, optional custom `ruleset`) → findings (code, message, severity, path) + counts |\n| `list_rulesets` | The artifact formats it governs and, per format, the rules it applies |\n| `list_formats` | The artifact formats the ruleset can lint |\n| `describe_rule` | Look a finding's `code` up → title, description, severity, tags, target path, and a remediation prompt |\n| `validate_ruleset` | Structurally validate a custom Spectral ruleset before you lint with it |\n| `request_review` | Get a ready-to-send email to engage [API Evangelist](https://apievangelist.com/services/) for expert governance services |\n\n### Formats\n\n`openapi` · `asyncapi` · `arazzo` · `apis-json` · `jsonschema` · `json-structure` ·\n`json-ld` · `mcp` · `plans` · `rate-limits` · `finops` · `agent-skill`\n\nThe `openapi` and `asyncapi` rulesets also extend the recommended Spectral engine rules;\nevery other format is linted entirely by its curated rules.\n\n## Use it\n\n```bash\nnpm install\nnpm start          # speaks MCP over stdio\n```\n\n### Claude Desktop / any MCP client\n\nAdd to your client's MCP server config (e.g. Claude Desktop `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"api-governance\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@api-common/api-governance-mcp\"]\n    }\n  }\n}\n```\n\nThen ask: *\"Lint this OpenAPI for governance issues and tell me what to fix.\"*\n\n## Part of the API Commons tools\n\nBrowser-first, backend-free tools for the APIs you produce and consume — **[API\nDiscovery](https://discovery.apicommons.org)**, **[API\nDocumentation](https://documentation.apicommons.org)**, **[API\nValidator](https://validator.apicommons.org)**, **[API\nReusability](https://reusability.apicommons.org)**, and **[MCP\nInstall](https://install.apicommons.org)**. This is the **AI surface** of the API\nValidator: the same Spectral governance, exposed to any agent over MCP. See them all at\n[apicommons.org/tools](https://apicommons.org/tools/).\n\n---\n\nA project of [API Evangelist](https://apievangelist.com), maintained openly under\n[API Commons](https://apicommons.org). The tooling is open and free to run yourself;\nAPI Evangelist offers the expert governance services around it. Apache-2.0.\n","readmeFilename":"README.md"}