npm @clervo/mcpstdioupdated 28d ago
Clervo lets software use AI models and agent tools with pay-per-use x402 payments, without managing separate provider accounts or API keys.
What can you do with Clervo Connect?
Clervo
Clervo lets software use AI models and agent tools with pay-per-use x402 payments, without managing separate provider accounts or API keys.
The public API is https://api.clervo.dev. Current products include AI, Web Search, Secure Sandbox, Prediction Intelligence, and Crypto Intelligence. Multi-chain RPC is not currently available through the public API.
Start
Make a free AI call:
curl -sS https://api.clervo.dev/v1/chat/completions \
-H 'content-type: application/json' \
-d '{"model":"clervo/laguna-s-2.1","messages":[{"role":"user","content":"Reply with ready."}],"max_completion_tokens":16}'
Connect Claude Code through MCP:
claude mcp add clervo -s user -- npx -y @clervo/mcp
Or choose another supported path at clervo.dev/start:
@clervo/sdkfor TypeScriptclervo-sdkfor Python@clervo/mcpfor Claude and other MCP clients@clervo/routerfor the CLI and local OpenAI-compatible proxy- OpenAPI for direct HTTP
The hosted API supports OpenAI Chat Completions at POST /v1/chat/completions, OpenAI Responses at POST /v1/responses, Anthropic Messages at POST /v1/messages, and the native Clervo route at POST /v1/ai/execute.
Payment safety
Free operations require no wallet. Paid operations return HTTP 402 with the maximum price before execution. Clervo clients keep automatic payment off by default and support per-operation limits, daily limits, receipts, reconciliation, and same-key replay without a second payment.
Payment uses USDC on Base through x402 or MPP. If settlement is unknown, retry only after reconciliation; never create a new authorization just to recover an uncertain request.
Current products, model availability, routes, and prices are machine-readable:
Work with the repository
The repository requires Node.js 24.18.1 and npm 10.9.8.
npm ci --ignore-scripts
npm run generate:discovery
npm run test:b13:clients
npm run site:build
Never place credentials, wallet material, customer payloads, or authentication files in issues or commits. Report security concerns through the repository's private vulnerability-reporting channel.
This source is currently unlicensed (UNLICENSED). No permission to copy, modify, or redistribute is granted unless Clervo publishes separate terms.
Install
Add Clervo Connect to your client. Pick the one you use.
claude mcp add mcp -- npx -y @clervo/mcpcodex mcp add mcp -- npx -y @clervo/mcpamp mcp add mcp -- npx -y @clervo/mcp{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mcp","command":"npx","args":["-y","@clervo/mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@clervo/mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@clervo/mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @clervo/mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation17/25
- Maintenance19/25
- Trust6/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 21 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.5.2Latest | Aug 11, 2026 |