ai·rete·rag MCP Server
Use ai·rete·rag — deterministic rule-based decisions with RAG-powered explanations — from Claude Code, Claude Desktop, or any MCP client.
The verdict always comes from the Rete rule engine (auditable, reproducible); the LLM only explains why, grounded in your ingested policy documents.
Tools
| Tool | What it does |
|---|---|
decide |
Make a decision in a domain — structured facts and/or free text, with optional Pattern 01 (rules scope retrieval) and Pattern 02 (retrieval into working memory) |
list_rules |
Inspect a domain's rules — conditions, verdicts, salience, overlaps |
get_rule_source |
Fetch a domain's rule set as editable YAML |
import_policy_rules |
Turn a written policy document into draft rules, each citing the sentence it encodes (nothing is saved — review, then put_rules) |
put_rules |
Create or replace a domain's rule set from YAML (dry_run to validate) |
ingest_text |
Add policy text to a domain's knowledge base |
list_documents |
Browse a domain's ingested documents |
get_usage |
Check your plan and remaining monthly decision quota |
Connect by URL (no install)
The server is also hosted, which is the only route for clients that connect to a URL and have no field for a static header — claude.ai and Claude Desktop custom connectors, in particular.
| URL | Auth | Reaches |
|---|---|---|
https://ai-rete-rag.com/mcp/auth |
Sign in with Google, once, in the browser | Your account — your domains, your plan quota |
https://ai-rete-rag.com/mcp |
None, or Authorization: Bearer ik_... |
Shared demo domains anonymously; your account with a key |
Add https://ai-rete-rag.com/mcp/auth as a custom connector and approve the
prompt. Connections are listed under Settings → Connected apps, and
disconnecting one takes effect immediately.
Install
No install needed with uv — uvx ai-rete-rag-mcp
fetches and runs the server on demand (see the config snippets below).
Alternatively, install it as a package:
pip install ai-rete-rag-mcp # from PyPI
pip install ./mcp-server # or from source, in this repo
Configure
First create an API key: sign in at ai-rete-rag.com,
open Settings → API Keys, and create a key (ik_... — shown once).
Claude Code
claude mcp add ai-rete-rag -e AI_RETE_RAG_API_KEY=ik_your-key-here -- uvx ai-rete-rag-mcp
(If you installed via pip, use -- ai-rete-rag-mcp instead of -- uvx ai-rete-rag-mcp.)
Or skip the install entirely and point it at the hosted endpoint with your key:
claude mcp add --transport http ai-rete-rag https://ai-rete-rag.com/mcp \
--header "Authorization: Bearer ik_your-key-here"
Claude Desktop / other clients (JSON)
{
"mcpServers": {
"ai-rete-rag": {
"command": "uvx",
"args": ["ai-rete-rag-mcp"],
"env": {
"AI_RETE_RAG_API_KEY": "ik_your-key-here"
}
}
}
}
(With a pip install, set "command": "ai-rete-rag-mcp" and drop "args".)
Environment variables:
| Variable | Default | Purpose |
|---|---|---|
AI_RETE_RAG_API_KEY |
(none) | Your API key — authenticates calls and ties them to your plan quota |
AI_RETE_RAG_API_URL |
https://ai-rete-rag.com |
API base URL — point at http://localhost:8000 for local dev |
Without a key you can still explore the shared demo domains (loan, fraud,
clinical, …) subject to free-tier limits.
Example
"Use ai·rete·rag to decide whether this loan application should be approved: credit score 645, annual income $52k, requested amount $30k."
Claude calls decide(domain="loan", facts={...}) and returns the rule-derived
verdict plus a plain-English explanation citing the underwriting policy.
Metadata
Release files for ai-rete-rag-mcp 0.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ai_rete_rag_mcp-0.8.0.tar.gz | 24.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ai_rete_rag_mcp-0.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.1 kB
Release files / ai_rete_rag_mcp-0.8.0.tar.gz
| Download URL | ai_rete_rag_mcp-0.8.0.tar.gz |
|---|---|
| Size | 24.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6a7556022c644465fd0d05116e812af46b5721fb4582d18dbf548f0b6319707e
|
|
BLAKE2b-256 checksum How to use checksums |
ac49b82a78197597f2b930c46774941ad24e90b13856c6647c58a2a0c96cbb2e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
Release files / ai_rete_rag_mcp-0.8.0-py3-none-any.whl
| Download URL | ai_rete_rag_mcp-0.8.0-py3-none-any.whl |
|---|---|
| Size | 16.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2120912b41e76cc1b6a2a23e645115ba4946f836a2bd9950b023204312ead751
|
|
BLAKE2b-256 checksum How to use checksums |
227760266c81aea488cc85a168bbf6391a7abf456ba4d3e780fe111605ce9798
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|