# Lordevo MCP server in Claude Desktop, Cursor, Cline and Windsurf

> Config snippets only; nothing to install from us.

The shop is a remote MCP server at `https://shop.lordevo.com/mcp` (streamable HTTP, no login). It lists 64 tools; these five are the ones this kit points to first:

| MCP tool | What it does | Price per call |
|---|---|---|
| `page_markdown` | A web page as clean, LLM-ready Markdown | $0.002 |
| `can_fetch` | robots.txt + AI-crawler permission check for a URL | $0.002 |
| `tech_stack` | What a site is built with (CMS, frameworks, analytics) | $0.002 |
| `dns_lookup` | DNS records (A, AAAA, CNAME, MX, TXT, NS, SOA, CAA) | $0.002 |
| `email_validate` | Email syntax + domain + MX (no mailbox probing) | $0.002 |

Prices are from the shop's price table (checked 13 Nov 2026; the published `lordevo-x402` 0.1.5 lists the same prices); each tool's title in `tools/list` shows its price, e.g. "($0.002/call)".

## Add the server
| Client | Where | Snippet |
|---|---|---|
| **Claude** (desktop or web) | Settings > Connectors > Add > Add custom connector, URL `https://shop.lordevo.com/mcp` | none needed |
| **Claude Desktop**, config file instead | `claude_desktop_config.json` (the file takes local servers only, so the `mcp-remote` bridge connects it to the remote URL; needs Node.js) | `claude-desktop.json` |
| **Cursor** | `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project) | `cursor.json` |
| **Cline** | MCP Servers > Configure > Configure MCP Servers (`cline_mcp_settings.json`; CLI: `~/.cline/data/settings/cline_mcp_settings.json`). `"type": "streamableHttp"` must be set; without it Cline uses legacy SSE | `cline.json` |
| **Windsurf** | Cascade's MCP menu > Open MCP config file (`mcp_config.json`: `~/.config/devin/mcp_config.json` on macOS/Linux, `%AppData%/devin/mcp_config.json` on Windows; the editor's own discovery file is `~/.codeium/windsurf/mcp_config.json`) | `windsurf.json` |

Merge the `lordevo` entry into the `mcpServers` object you already have.

## Free trial
Two tools are free: `list_services` and `get_sample_output`; `try_free` and `preflight` are free while the trial and preflight are on. For a free trial call, tell the agent to add `"trial": true` to the tool arguments (or to call `try_free`): 3 calls per IP per UTC day on tools priced up to $0.005, which covers all five tools above. Example prompt: "Call page_markdown on https://example.com with trial true."

## How payment works
After the free calls, a paid tool returns the x402 PaymentRequired as its result (`isError: true`, price and terms in `structuredContent`). Claude, Cursor, Cline and Windsurf cannot sign that payment themselves. Two ways to pay per call:
- a wallet MCP server such as Coinbase's `@coinbase/payments-mcp` next to this one (it pays x402 HTTP endpoints; point it at `https://shop.lordevo.com/api/quick/<tool>?...`), see https://shop.lordevo.com/guides/mcp;
- your own MCP client that signs the PaymentRequired with an x402 client and resends the call with the payment in `params._meta["x402/payment"]` (https://shop.lordevo.com/guides/mcp).

Payments are USDC on Base; answers of 400 or higher are not charged.

## Run the example
```bash
npm i @modelcontextprotocol/sdk
node example.mjs
```
For each of the 4 config files it reads the server URL, connects, and lists the tools; then it makes one free trial call and one unpaid call and prints the payment terms. Nothing is paid.

## Files
- [claude-desktop.json](https://shop.lordevo.com/guides/sdk/mcp-clients/claude-desktop.json)
- [cline.json](https://shop.lordevo.com/guides/sdk/mcp-clients/cline.json)
- [cursor.json](https://shop.lordevo.com/guides/sdk/mcp-clients/cursor.json)
- [example.mjs](https://shop.lordevo.com/guides/sdk/mcp-clients/example.mjs)
- [windsurf.json](https://shop.lordevo.com/guides/sdk/mcp-clients/windsurf.json)

All SDK guides: https://shop.lordevo.com/guides/sdk