git clone https://github.com/Kedar7412/edgeroute-mcp.git
cd edgeroute-mcp
python -m venv venv
Activate virtual environment:

Windows: venv\Scripts\activate
macOS / Linux: source venv/bin/activate
2. Install Dependencies
bash


pip install -r requirements.txt
3. Seed Baseline Intelligence
bash


python seed_anchors.py
4. Interactive Live Test
bash


python interactive.py
🔌 Client Setup Guides
1. Kiro
Add to your Kiro user config (Ctrl + Shift + P → Kiro: Open user MCP config (JSON)):

json


{
  "mcpServers": {
    "edgeroute": {
      "command": "python",
      "args": ["/absolute/path/to/decision_engine_mcp.py"],
      "disabled": false,
      "autoApprove": ["*"]
    }
  }
}
To make Kiro automatically query EdgeRoute on every prompt without manual commands, create .kiro/steering/edgeroute.md:

markdown


---
inclusion: always
---
Before taking actions, query `route_decision` from `edgeroute`. If `abstained` is false, follow the recommended action. Log outcomes using `log_outcome`.
2. Cursor
Create or edit .cursor/mcp.json in your workspace root:

json


{
  "mcpServers": {
    "edgeroute": {
      "command": "python",
      "args": ["/absolute/path/to/decision_engine_mcp.py"]
    }
  }
}
3. Claude Desktop
Add to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
json


{
  "mcpServers": {
    "edgeroute": {
      "command": "python",
      "args": ["/absolute/path/to/decision_engine_mcp.py"]
    }
  }
}
4. Claude Code (CLI)
Add to your global Claude CLI configuration (~/.claude.json):

json


{
  "mcpServers": {
    "edgeroute": {
      "command": "python",
      "args": ["/absolute/path/to/decision_engine_mcp.py"]
    }
  }
}
5. Windsurf / Codeium
Open Settings → MCP Servers and add:

json


{
  "mcpServers": {
    "edgeroute": {
      "command": "python",
      "args": ["/absolute/path/to/decision_engine_mcp.py"]
    }
  }
}
6. VS Code (Cline / Roo Code)
In the Cline MCP settings tab, click Add New MCP Server and paste the JSON configuration.

🛠️ MCP Tools Reference
Tool	Parameters	Description
route_decision	context: string	Evaluates prompt context in < 2 ms and returns top action, probabilities, and abstention status.
log_outcome	context: string, selected_action: string, accepted: bool	Logs user acceptance or override into the local SQLite replay buffer for future fine-tuning.
train_head	epochs: int, batch_size: int	Executes local mini-batch SGD on accumulated experience and commits updated weights.
get_savings_report	(none)	Returns a lifetime ROI summary showing tokens saved, time saved, and monetary value generated.
📄 License
Distributed under the MIT License. See LICENSE for more information.



---
### Push it to GitHub
After saving and closing Notepad, run these 3 commands in your terminal:
```cmd
git add README.md
git commit -m "docs: update full README documentation"
git push