pydanticcontract-mcp — Claude Code MCP server: setup guide
A hosted MCP server that verifies Pydantic AI structured outputs, diffs schemas, and generates audit receipts for agent pipelines.
claude mcp add --transport http pydanticcontract-mcp https://pydanticcontract.clauxel.com/mcpWhat pydanticcontract-mcp does
This remote endpoint adds contract validation to automated pipelines. It exposes four tools: contract_validate for checking data structures, schema_diff for comparing two specifications, repair_hint to suggest fixes for schema errors, and contract_receipt to produce verifiable audit records.
The service is hosted commercially. Production requests will fail without a bearer token passed in the Authorization header, and your client environment needs Streamable HTTP transport support. Requests sent without authentication receive a structured JSON error payload.
What it helps with
- validate Pydantic AI model output using
contract_validate - compare data schemas for differences via
schema_diff - generate fix recommendations for broken schemas using
repair_hint - produce verifiable execution receipts with
contract_receipt
Example prompts for the agent
- Validate this structured model response against our schema with
contract_validate - Check what changed between these two JSON schemas using
schema_diff - Inspect the validation failure and get a fix suggestion with
repair_hint
How to install pydanticcontract-mcp
Platform CLI: remote server
claude mcp add --transport http pydanticcontract-mcp https://pydanticcontract.clauxel.com/mcpPlatform CLI: remote server
codex mcp add pydanticcontract-mcp --url https://pydanticcontract.clauxel.com/mcpConfig file
{
"mcpServers": {
"pydanticcontract-mcp": {
"url": "https://pydanticcontract.clauxel.com/mcp"
}
}
}Config file
{
"servers": {
"pydanticcontract-mcp": {
"type": "http",
"url": "https://pydanticcontract.clauxel.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http pydanticcontract-mcp https://pydanticcontract.clauxel.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pydanticcontract-mcp
How do I install pydanticcontract-mcp in Claude Code?
Run claude mcp add --transport http pydanticcontract-mcp https://pydanticcontract.clauxel.com/mcp. You will also need an API token configured for production requests.
Which tools does pydanticcontract-mcp provide?
It provides four remote tools: contract_validate, schema_diff, repair_hint, and contract_receipt. They handle output verification, schema comparisons, and audit tracking.
Does pydanticcontract-mcp require an API key?
Yes, this is a paid hosted server that requires a bearer token in the Authorization header. Unauthenticated requests to the endpoint return a JSON error response.
