sarcire-mcp

MCP server for Sarcire — operational error oracle for autonomous agents.

Tools

| Tool | Description | |------|-------------| | sarcire_preview | Quick fix preview — returns confidence + summary. Fast and free. | | sarcire_get_fix | Full step-by-step fix. Credits required for novel generation. | | sarcire_check_plan | Structured remediation plan with safety verdict. | | sarcire_report_outcome | Report whether a fix worked — improves quality over time. | | sarcire_submit_fix | Contribute a new fix to the corpus. |

Using with Claude Managed Agents

Connect via the remote MCP endpoint (Streamable HTTP, no Node.js install needed):

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://talented-victory-production-bfcd.up.railway.app/mcp",
      "name": "sarcire",
      "authorization_token": "sc_install_your_id_here"
    }
  ]
}

Generate your install_id once and reuse it across sessions to maintain credit balance and outcome history.

Using with Claude Code (local stdio)

claude mcp add sarcire -- npx -y sarcire-mcp

Or set install_id via environment variable (recommended for teams / CI):

SARCIRE_INSTALL_ID=sc_install_your_id claude mcp add sarcire -- npx -y sarcire-mcp

On first run without SARCIRE_INSTALL_ID, a new id is generated and saved to ~/.sarcire/config.

Environment variables

| Variable | Description | |----------|-------------| | SARCIRE_INSTALL_ID | Your install id. Highest priority; skips file write. | | SARCIRE_API_URL | Override the API base URL (default: Railway deployment). | | SARCIRE_X402_WALLET_KEY | Private key for automatic x402 USDC payment. | | auto_preview_hint | "true" to append a hint suggesting sarcire_get_fix after previews. | | auto_report_hint | "true" to append a hint suggesting sarcire_report_outcome after fixes. |

Example workflow

1. Error occurs in agent loop
2. Call sarcire_preview(error_text=...) → confidence 0.94, fix available
3. Call sarcire_get_fix(error_text=...) → step-by-step fix
4. Apply fix, retry
5. Call sarcire_report_outcome(query_decision_id=..., outcome="resolved")

Credits

• Vector cache hits are free
• Novel fix generation costs 1 credit
• Purchase credits at sarcire.dev

MIT License · sarcire.dev