Enables AI agents to perform commerce operations and manage local wallet state through bounded, opt-in transactions.
Also known as clervo/clervo, connect, @clervo/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 242
- Latest version
- 0.5.2
- Last commit
- Nov 4, 2026
- License
- —
What is Clervo Connect MCP?
Clervo Connect enables AI agents to perform commerce operations and manage local wallet state through bounded, opt-in transactions.
Summary generated from the project's README
About Clervo Connect MCP server
Clervo Connect provides a stdio MCP server that allows AI agents to manage commerce operations and local wallet states. Developers can integrate this server into clients like Claude Code using a simple npx command. It connects to a production origin at api.clervo.dev by default, though users can specify a different base URL for development purposes. The server uses profiles such as research, ai, prediction, crypto, sandbox, or full to ensure agents only access relevant schemas.
Security is a core component of the architecture. The server exposes tools like clervo_execute for operations, while connect_status, spend_limits, local_usage, reconcile, and doctor provide access to local state without revealing wallet secrets. Automatic payments are disabled by default, requiring an explicit --auto-pay flag to enable. Even with this flag, the Router enforces per-operation and daily ceilings on every quote to prevent unauthorized spending. The system blocks unknown settlements and avoids blind retries to maintain strict control over financial transactions.
What you can do with it
- 1Execute commerce operationsAn AI agent can perform specific commercial tasks using the clervo_execute tool within a selected profile.
- 2Monitor wallet spending limitsA developer can instruct an agent to check current spending constraints and local usage statistics.
- 3Manage agent-specific tool schemasYou can restrict an AI agent to a specific set of commerce tools by loading a specialized profile.
- 4Perform bounded automated paymentsAn agent can be configured to handle payments automatically while staying within predefined financial ceilings.
Written from the project's README. Every use case is checked against a quote from it.
How to install Clervo Connect MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Clervo Connect MCP in Claude Code
$ claude mcp add connect -- npx -y @clervo/mcpInstall Clervo Connect MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"connect": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Install Clervo Connect MCP in VS Code
.vscode/mcp.json
{
"servers": {
"connect": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Install Clervo Connect MCP in VS Code CLI
$ code --add-mcp '{"name":"connect","type":"stdio","command":"npx","args":["-y","@clervo/mcp"]}'Install Clervo Connect MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"connect": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Install Clervo Connect MCP in Codex
$ codex mcp add connect -- npx -y @clervo/mcpInstall Clervo Connect MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.connect] command = "npx" args = ["-y", "@clervo/mcp"]
Install Clervo Connect MCP in Gemini CLI
$ gemini mcp add -s user connect npx -- -y @clervo/mcpInstall Clervo Connect MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"connect": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableclervo/clervo is public and reachablegithub.com/clervo/clervo ↗Pass
- Package names this repository as its source@clervo/mcp names clervo/clervo as sourcenpmjs.com/package/@clervo/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @clervo/mcpnpmjs.com/package/@clervo/mcp/v/0.5.2#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-04github.com/clervo/clervo ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @clervo/mcpPass
- No critical advisory in the package or its dependencies118 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@clervo/mcp
Stdio MCP server for Clervo Connect. A clean one-command install uses the public production origin and the same local wallet, limits, receipts and unresolved operation state as every other Connect surface:
{
"mcpServers": {
"clervo": { "command": "npx", "args": ["-y", "@clervo/mcp"] }
}
}
Claude Code:
claude mcp add clervo -s user -- npx -y @clervo/mcp
The default origin is https://api.clervo.dev. Set CLERVO_BASE_URL only for
another HTTPS deployment or loopback development.
Use --profile research|ai|prediction|crypto|sandbox|full to load only the
schemas relevant to an agent. Profiles are checked against the live registry on
every execution. RPC is not exposed while runtime truth reports it unavailable.
Alongside useful Search and AI tools, clervo_execute safely exposes operations
served in the selected profile. connect_status, spend_limits, local_usage,
reconcile, and doctor expose shared local state without wallet secrets.
Automatic payment is off by default. --auto-pay is an explicit local opt-in;
even then, every quote is bounded by the Router's per-operation and daily
ceilings before signing. Unknown settlement blocks MCP and every other Connect
surface. Reconciliation and same-key replay carry no fresh payment
authorization, and the server never blindly retries.
The package writes MCP protocol messages to stdout and operational failures to stderr only. This client code is MIT licensed; use of the hosted Clervo service remains subject to its service terms.
Clervo Connect MCP questions
How do I add Clervo Connect MCP to Claude Code?
Run claude mcp add connect -- npx -y @clervo/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Clervo Connect MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install the Clervo MCP server?
You can install it using a one-command npx execution by adding it to your mcpServers configuration.
Is automatic payment enabled by default?
No, automatic payment is disabled by default and requires an explicit local opt-in using the --auto-pay flag.
Can I limit the tools available to the AI agent?
Yes, you can use specific profiles like research, ai, or crypto to load only the relevant schemas for your agent.