Live API contract layer for AI coding assistants.
Conciliate keeps Claude, Cursor, and VS Code Copilot in sync with your real microservices — across environments, specs, and code changes — so AI-generated code always matches your APIs.
The Problem
- AI suggests endpoints that don't exist or are out of date
- Frontend and backend assistants disagree about the API
- Microservice and third-party APIs change silently
- No contract validation between AI-generated code and real APIs
Features
- Contract extraction: Auto-generates OpenAPI specs from FastAPI, Flask, Express
- Multi-service registry: Track local microservices, staging, production, third-party APIs
- Request validation: Validate AI-generated requests against live contracts
- MCP-native: Built for Claude Desktop, Cursor, VS Code Copilot
- Change detection: Real-time diff tracking with AI-consumable narration
- Local-first: No cloud dependencies, runs entirely on your machine
Quick Start
pip install conciliate
cd /path/to/your/project
conciliate init # Create .conciliate.yaml
conciliate mcp # Run MCP server for AI assistants
CLI Commands
| Command | Description |
|---|---|
conciliate init |
Create config file |
conciliate mcp |
Run MCP server for AI assistants (recommended) |
conciliate watch |
Watch backend + serve REST API |
conciliate serve |
REST API only |
conciliate summary |
Display API summary |
conciliate diff |
Show recent contract changes |
conciliate status |
Show configuration |
conciliate optimize <query> |
Generate query-scoped context shard and token savings |
MCP Tools
| Tool | Description |
|---|---|
list_services |
List all registered microservices |
list_endpoints |
List endpoints for a service |
validate_request |
Validate request against live contract |
explain_diff |
Explain API changes between environments |
search_endpoints |
Search across all services |
get_endpoint_details |
Get full schema for an endpoint |
reload_api_spec |
Force-reload specs |
optimize_context |
Build query-scoped shard under token budget |
REST API
| Endpoint | Description |
|---|---|
GET /spec |
Full OpenAPI specification |
GET /summary |
Human-readable summary |
GET /diff |
Latest contract changes |
POST /reload |
Trigger spec regeneration |
GET /services |
List all services |
POST /validate |
Validate request against contract |
GET /contract/issues |
Detect cross-service contract mismatches |
POST /context/optimize |
Build query-scoped shard under token budget |
GET /context/metrics |
View token-savings optimization metrics |
Troubleshooting
| Issue | Solution |
|---|---|
| "Failed to generate spec" | Check backend_path in config |
| "No .conciliate.yaml found" | Run conciliate init |
| MCP not connecting | Restart AI assistant, verify cwd path |
| Framework not detected | Set framework explicitly in .conciliate.yaml |
1 maintainer
Metadata
1 maintainer
Release files for conciliate 0.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| conciliate-0.7.2.tar.gz | 42.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| conciliate-0.7.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.7 kB
Release files / conciliate-0.7.2.tar.gz
| Download URL | conciliate-0.7.2.tar.gz |
|---|---|
| Size | 42.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4dc7776b3675f2d0ef0a440669af50961cad3c1ca0b98c1142626276996a5298
|
|
BLAKE2b-256 checksum How to use checksums |
7249aee25544e698f64fccb7fd2859a0e09fb9e301d929f5f53f42e17e7fc2af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 12, 2026.
Transparency logRelease files / conciliate-0.7.2-py3-none-any.whl
| Download URL | conciliate-0.7.2-py3-none-any.whl |
|---|---|
| Size | 42.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9ac3b8818e7531bad63b5d73a40ffc0b778d64e0df396c5aa798f88d57feb75
|
|
BLAKE2b-256 checksum How to use checksums |
0f924e639dbd385747b3a936f917a7d2700ad307a9c1f37a957381864d42b4c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 12, 2026.
Transparency log
