← All guides · Markdown: /guides/mcp.md

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

Add the server (https://shop.lordevo.com/mcp, streamable HTTP, JSON responses, no login)

{
  "mcpServers": {
    "lordevo": {
      "url": "https://shop.lordevo.com/mcp"
    }
  }
}
{
  "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:

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:

Errors (nothing is charged on any of these)

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

Checked

Written 2026-10-30 against the current public docs:

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.