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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ai_rete_rag_mcp-0.7.0.tar.gz.
File metadata
- Download URL: ai_rete_rag_mcp-0.7.0.tar.gz
- Upload date:
- Size: 23.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6cfeddc562ddcf90af0581dfe5de4063e9a2ad99e0b80755fa9ddc7e9a26c6a6
|
|
| MD5 |
bb2c3f3cf86ac31299706f9e12337dbd
|
|
| BLAKE2b-256 |
aa69d04145c209f904e5eda055f2e1197df768aad171f00fe0b617845b40e081
|
File details
Details for the file ai_rete_rag_mcp-0.7.0-py3-none-any.whl.
File metadata
- Download URL: ai_rete_rag_mcp-0.7.0-py3-none-any.whl
- Upload date:
- Size: 16.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b6cdb812fe9f86d161525b8aae3bafc8b7fc99997bfd725161ae657c6cf252e
|
|
| MD5 |
adb72f2263c63b149ddd307b4eaa7a1f
|
|
| BLAKE2b-256 |
467383a7d902fb38bcf0b081dff30b5bcc94063d1cbd6997937376dfc0b42e13
|