MCP

Link preview server

Streamable HTTP, no session, at https://cardscope.dev/mcp. Tools:

• check_link_preview — url (required) and platforms (optional). Returns the same JSON as /v1/preview, then a one-line summary.
• list_platforms — the 11 apps and the doc URLs each rule cites.

A Bearer key is optional. Without one, the server allows 20 calls a day from one IP and the result says how to add a free key (300 a month). An invalid key is rejected; it does not fall through to the anonymous allowance. Don’t put the key in a chat you share.

Cursor

Add this to ~/.cursor/mcp.json (or the project .cursor/mcp.json):

{
  "mcpServers": {
    "cardscope": {
      "url": "https://cardscope.dev/mcp",
      "headers": {
        "Authorization": "Bearer cs_live_…"
      }
    }
  }
}

Claude Code

claude mcp add cardscope --transport http https://cardscope.dev/mcp \
  --header "Authorization: Bearer cs_live_…"

Omit --header to use the anonymous allowance.

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "cardscope": {
      "type": "http",
      "url": "https://cardscope.dev/mcp",
      "headers": {
        "Authorization": "Bearer cs_live_…"
      }
    }
  }
}

The registry name is dev.cardscope/link-preview. server.json at the repo root is the publish file.