# MCP clients: Claude, Cursor, Cline, payments-mcp

Add the shop's MCP server to Claude, Cursor or Cline: free tools and free trial calls work at once; paid calls need an x402 wallet.

For: any MCP client. Endpoint shape: `GET https://shop.lordevo.com/api/quick/<tool>?<input>` (HTTP 402 with x402 terms until paid). All guides: https://shop.lordevo.com/guides

Easier: copy-paste client configs: https://shop.lordevo.com/guides/sdk/mcp-clients

## Prerequisites
- A wallet on Base mainnet holding a little USDC. One `dns-lookup` call costs $0.003; quick tools cost $0.003 to $0.02 per call, so $0.10 of USDC covers 33 `dns-lookup` calls. Payments are x402 `exact` USDC transfers that your wallet signs; the facilitator submits them, so the wallet needs no ETH for gas.
- The wallet's private key in the environment variable `AGENT_WALLET_KEY`, never in code. Use a separate agent wallet with a small balance: an x402 client pays the amount the 402 asks for (the shop's prices are fixed per tool, listed in https://shop.lordevo.com/catalog.json).
- No account, sign-up or API key. Instant tools that fail or are refused are not charged. Long jobs (202) are charged when accepted and are not refunded automatically if they fail later. If a paid job failed, email hello@lordevo.com with the transaction hash and we'll review it, usually within 2 business days.
- To try without a wallet: 3 free calls per IP per UTC day on the 52 tools priced up to $0.005 (opt-in, see below).

## Add the server (https://shop.lordevo.com/mcp, streamable HTTP, JSON responses, no login)
- **Claude (desktop or web)**: Settings > Connectors > Add > Add custom connector, URL `https://shop.lordevo.com/mcp`.
- **Cursor**: `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
```json
{
  "mcpServers": {
    "lordevo": {
      "url": "https://shop.lordevo.com/mcp"
    }
  }
}
```
- **Cline**: MCP Servers > Configure (cline_mcp_settings.json):
```json
{
  "mcpServers": {
    "lordevo": {
      "type": "streamableHttp",
      "url": "https://shop.lordevo.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

## Try it free
Free tools: `list_services`, `get_sample_output`, `preflight` (would a paid fetch tool work on this URL?), `try_free` (runs a paid tool on the free trial). For a free trial call, the agent adds `"trial": true` to the tool arguments, or calls `try_free` with `{"tool":"dns_lookup","arguments":{...}}` (3 calls per IP per UTC day on tools up to $0.005). Tell your agent, for example: "Call dns_lookup with trial true."
The same call as raw JSON-RPC:
```bash
curl -s https://shop.lordevo.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"dns_lookup","arguments":{"host":"example.com","trial":true}}}'
```

## Pay per call
Without payment a paid tool returns the x402 PaymentRequired result (`isError: true`, terms in `structuredContent`, price $0.003 for dns_lookup). Claude, Cursor and Cline cannot sign that payment themselves. Two ways to pay:
- **Coinbase payments-mcp** (wallet MCP server for Claude Desktop, Claude Code, Codex CLI, Gemini CLI and other stdio MCP clients): `npx @coinbase/payments-mcp`, sign in, add USDC and set its spending limits. It pays x402 HTTP endpoints, so point the agent at the HTTP URL, e.g. `https://shop.lordevo.com/api/quick/dns-lookup?host=example.com`.
- **Your own MCP client**: sign the PaymentRequired with any x402 v2 client (see the x402-fetch guide) and call the same tool again with the payment in `params._meta["x402/payment"]`; the result carries `_meta["x402/payment-response"]`.

## Errors (nothing is charged on any of these)
- **400 / 422**: bad or unusable input (body `{"error", "message", "charged": false}`). Fix the input; do not retry as is.
- **403**: robots.txt does not allow the shop to fetch that URL. Pick another URL.
- **402**: payment needed. On a trial request, `free_trial.status` says why: `used_up_today` (3 free calls used; resets 00:00 UTC), `daily_cap_reached` (the shop's daily trial cap) or `not_eligible` (tool above $0.005). Pay per call instead. With a paying client, a final 402 means the payment was not accepted: check the USDC balance on Base (eip155:8453).
- **429 / 503**: busy or rate-limited. Wait `Retry-After` seconds, then retry once.
- **409** `payment_in_use`: the same signed payment was sent twice at once. Make a new call.

Over MCP, errors are tool results with `isError: true` and the same `error` codes; a used-up trial shows in `_meta["lordevo/free_trial"].status`.

## Next tools to try
- `can-fetch` ($0.003, free trial ok): Can I fetch this URL? robots.txt + AI-crawler permission gate. `GET https://shop.lordevo.com/api/quick/can-fetch?url=https://example.com/blog/post`
- `page-markdown` ($0.003, free trial ok): URL to Markdown: LLM-ready web page reader (main content). `GET https://shop.lordevo.com/api/quick/page-markdown?url=https://example.com`
- `site-check` ($0.02): Site check: URL risk signals + AI readiness + security headers (recommended start). `GET https://shop.lordevo.com/api/quick/site-check?url=https://example.com`
- `email-validate` ($0.003, free trial ok): Email validation / email verification API (syntax + domain + MX, no SMTP probing). `GET https://shop.lordevo.com/api/quick/email-validate?email=jane@example.com`
- `pdf-text` ($0.003, free trial ok): PDF to text, page by page. `GET https://shop.lordevo.com/api/quick/pdf-text?url=https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf`
- All 58 tools with prices and inputs: https://shop.lordevo.com/catalog.json, https://shop.lordevo.com/llms.txt, https://shop.lordevo.com/quick

## Checked
Written 2026-10-30 against the current public docs:
- https://modelcontextprotocol.io/docs/develop/connect-remote-servers (Claude custom connectors)
- https://cursor.com/docs/context/mcp (Cursor mcp.json)
- https://docs.cline.bot/mcp/configuring-mcp-servers (Cline streamableHttp)
- https://docs.cdp.coinbase.com/payments-mcp/welcome (@coinbase/payments-mcp)
The JSON-RPC call was run against a local copy of this shop on 2026-10-30 and again on 2026-11-09, with a paid call (payment in params._meta["x402/payment"], test network, test facilitator); the client settings follow the docs above and were not tried in each client.
