Wraps any MCP server: identical write-tool calls run once, and every tool call is audit-logged.
The reliability layer for what AI agents do.
AgentRaaS sits between your agents and the APIs they act on. Every call runs once even when it is retried, is checked against what that agent may do, waits for a human when it is risky, and is recorded. Connect by webhook URL, SDK headers or MCP. The core is open source and free to self-host.
Look first: live read-only demo,
no signup. Built-in services include Stripe, Slack, GitHub, HubSpot, Resend,
SendGrid, Notion, Zendesk, Jira, Twilio, Shopify and Alpaca (trading); any other HTTP API works as a
Custom Action and any MCP tool through agentraas wrap.
Your n8n workflow calls Stripe. It times out, n8n retries, and the customer is charged twice. Your agent creates a HubSpot contact, the response is lost, the agent retries, and now there are two.
flowchart LR
Agent["Agent<br/>(n8n, Python, MCP)"] -->|request| P
subgraph P["AgentRaaS"]
direction TB
D["Deduplicate"] --> V["Policies and validation"] --> C["Circuit breaker"] --> A["Audit log"]
end
P -->|forwarded once| API["API<br/>(Stripe, Twilio, HubSpot, any URL)"]
409 while the first is still in flight.A call that times out after it was sent is treated as outcome unknown:
never retried, its slot kept, sent to the dead-letter queue. Every forwarded
call also carries Idempotency-Key: agentraas-<hash>, so providers that honor
it (Stripe and others) run it once even on a replay.
pip install agentraas runs entirely on your machine.
agentraas chaos --mock -- python my_agent.py # find calls that would run twice
from agentraas.local import exactly_once
@exactly_once()
def charge(customer, amount, idempotency_key=None):
return stripe.Charge.create(customer=customer, amount=amount, idempotency_key=idempotency_key).id
protect_tool for LangChain/LangGraph and CrewAI, protectTools for the
Vercel AI SDK (npm install agentraas).agentraas wrap -- <mcp server> gives any MCP server exactly-once write
tools and a log. In the official MCP Registry.agentraas scan lists which tools in your MCP servers can move money,
delete data, run code or send messages, without calling any of them
(GitHub Action for pull requests).Details: src/sdk/README.md, src/sdk-js.
git clone https://github.com/agentraas/agentraas.git
cd agentraas
./install.sh
install.sh generates the secrets, builds the image (the first Rust build
takes a few minutes), starts Postgres, Redis and MinIO, and runs the
migrations. Then open http://localhost:13001/dashboard and register.
Kubernetes: a Helm chart is in infra/helm/. Render: one-click deploy.
Works with Docker or Podman. Linux: either one. macOS: Docker Desktop (or
Colima).
Windows: Docker Desktop with WSL2; run ./install.sh from a WSL terminal,
with the repo cloned inside WSL (not on C:\).
On SELinux hosts, install.sh relabels the bind mounts. After changing files
by hand, recreate (docker compose or podman-compose, down then up -d)
rather than restart.
"5000") are held to the same
limits.Curated services (Stripe, Twilio, HubSpot, Shopify, Slack, PayPal, Alpaca
paper and live trading and more in config/services.json), or register any
URL as a Custom Action, SSRF-guarded. Guardrails for trading agents:
agentraas.io/trading.
If you only call Stripe from your own code, its Idempotency-Key is enough.
AgentRaaS is for the rest: providers without one (most SaaS APIs and every
internal endpoint), no-code tools that can't set headers (n8n, Make, Zapier),
and one audit trail across every service an agent touches.
It fails closed. Nothing in the SDKs, the n8n node or the MCP gateway falls back to calling the API directly, because that is exactly the unguarded retry this product exists to stop. Treat it like a database on your critical path.
Latency: 2.1 to 2.4 ms added at the median, 2.9 to 3.7 ms at p95, measured
on one machine (Intel Core i3-12100, local stack, three runs of 500 calls) with
infra/scripts/bench-overhead.py. A retried duplicate is answered from cache.
| Self-hosted (Community + Team) | Enterprise | |
|---|---|---|
| Price | Free, no license key | Talk to us |
| Limits | No action limit, up to 3 seats | Unlimited seats |
| Includes | Exactly-once execution, MCP gateway, dashboard, audit trail, DLQ, undo, record and replay, spend caps and action policies, DLP redaction, human approvals, semantic dedup, SSO | Everything in Self-hosted, plus agent identity, inbound webhooks, white-label branding, service keys read from your own secrets manager |
AgentRaaS Cloud starts with a free trial of 1,000 actions with every feature, for trying it out; for production, self-host. The core server is AGPL-3.0; the Team and Enterprise features are source-available (see LICENSE.md).
cd src/api-gateway-rs
cargo test --workspace --features enterprise # unit tests
TEST_BASE_URL=http://localhost:13001 npm test # integration tests, real server
The integration tests send concurrent duplicates, replays and failures
through the built-in mockpay service, so no real API keys are needed.
mockpay so far).agentraas.io/docs has the API, the troubleshooting guide and self-hosting details. Questions: agentraas.io/community (GitHub Discussions).
The server is AGPL-3.0. The Team and Enterprise features
(crates/api/src/ee/, crates/core/src/{semantic_dedup,hmac_verify}.rs,
compose.ee.yaml) are source-available under the AgentRaaS Enterprise
License from 0.16.0: free to read and try, production use needs a license
key (releases 0.10.0 to 0.15.1 stay under the Functional Source License).
The SDKs are MIT/Apache-2.0. See LICENSE.md.
CONTRIBUTING.md · SECURITY.md (report vulnerabilities privately, not as issues) · CODE_OF_CONDUCT.md
Built with Rust (Axum, Tokio, sqlx), Postgres and Redis.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
uvx agentraasMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-agentraas-agentraas": {
"command": "uvx",
"args": [
"agentraas"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceagentraaspypiAgentRaaS wrap works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.