k11 API Contract QA
MCP server that shows which services an API change breaks, across five contract formats
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About k11 API Contract QA
k11 API Contract QA is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.
Spec-diff tools say a change is breaking but not who it breaks. This server reads a consumers file, .qa-mcp/consumers.yaml, listing each consuming service with an owner, a criticality and the fields it reads or sends. A removed field then counts only against consumers that use it, and the verdict is one of breaking, breaking with no known consumer, or compatible. It recommends a human decision when two or more consumers break or a critical one does.
It handles OpenAPI 3.x, Swagger 2.0, GraphQL, gRPC/protobuf, AsyncAPI 2.x and 3.x, and SOAP/WSDL 1.1, with rules specific to each, such as protobuf field-number reuse or GraphQL argument removal. Specs can be files or git refs like origin/main:openapi.yaml. Consumer discovery scans source code in Python, Java, TypeScript, Go and others for calls to your API, with file and line.
Checks are deterministic with no LLM calls. A contract-ci command writes a pull-request comment listing affected consumers and sets a failing exit code according to --fail-on. Live conformance checks and test generation are for REST only. Python 3.10 or newer is required.
Install
Run in a terminal
claude mcp add api-contract-qa -- uvx k11-api-contract-qa-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"api-contract-qa": {
"command": "uvx",
"args": [
"k11-api-contract-qa-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"api-contract-qa": {
"command": "uvx",
"args": [
"k11-api-contract-qa-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"api-contract-qa": {
"type": "stdio",
"command": "uvx",
"args": [
"k11-api-contract-qa-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"api-contract-qa": {
"command": "uvx",
"args": [
"k11-api-contract-qa-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"api-contract-qa": {
"command": "uvx",
"args": [
"k11-api-contract-qa-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
QA_MCP_ROOTFolder of the service or repo with the spec (default: current directory)
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- list_operations
- List a contract's operations and detected format.
- diff_contracts
- Classify every change between two contract versions.
- assess_impact
- Show which consumers a change breaks and the verdict.
- discover_consumer_usage
- Find a consumer's calls to your API in its source.
- check_deployed_contract
- Compare a running service's contract with the spec.
- check_live_conformance
- Call a running REST endpoint and check the response against the spec.
- generate_api_tests
- Generate REST contract tests.
- write_test
- Write generated test files under tests/ or src/test/.
What it does
- Consumer-aware impact
- Counts a breaking change only against the consumers that use the affected field.
- Six contract formats
- OpenAPI, Swagger, GraphQL, gRPC, AsyncAPI and SOAP/WSDL.
- Consumer discovery
- Scans consumer code for API calls and drafts consumers.yaml entries.
- Deployed drift check
- Compares a running service's published contract with the spec.
- Contract test generation
- Writes pytest with httpx or REST Assured tests for REST.
- Pull-request CI report
- contract-ci comments with every affected consumer and the reason.
Good for
- Review whether a pull request breaks other services
- Find who calls an endpoint before removing it
- Detect drift between a deployed GraphQL schema and its spec
- Generate contract tests for a REST API
- Fail CI only when a known consumer breaks
Pricing
Open source
Installs from PyPI; no price listed
k11 API Contract QA FAQ
Does it use an LLM to decide?
No. The README says the rules are deterministic and give the same result every run.
How does it know who my consumers are?
From a consumers.yaml file; discover_consumer_usage can draft entries from consumer code.
Which CI exit modes exist?
--fail-on accepts breaking, needs-human, any-breaking and never.
What runtime does it need?
Python 3.10 or newer; it installs as k11-api-contract-qa-mcp from PyPI.
Can the generated tests overwrite files?
write_test only writes under tests/ or src/test/ and does not overwrite unless asked.
Is k11 API Contract QA free?
Yes. k11 API Contract QA is open source, so you can use and self-host it for free.
How do I add k11 API Contract QA to Claude Code?
Run this command in your terminal: claude mcp add api-contract-qa -- uvx k11-api-contract-qa-mcp
What are the best alternatives to k11 API Contract QA?
The closest alternatives to k11 API Contract QA are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


