ConvertRails
MCP Server

01 —

Server information

02 —

Authentication

Authentication is not required to browse and search products. Buyers only need to authenticate to create a checkout session. Authentication uses standard OAuth 2.0 authorization code flow with PKCE.

During authorization the user provides their email address. This email is used to deliver the license key after payment. No password is required.

03 —

Tools

search_products readOnly

Search for digital products across all ConvertRails merchants. Returns up to 50 results per page with prices and purchase identifiers. Supports pagination.

Returns: { results[], total, page, limit, query, hint } — each result includes merchant_id, sku, name, description, price, currency, type.

get_product readOnly

Retrieve full details for a specific product by merchant ID and SKU.

Returns: Full product record including name, description, price, currency, type, fulfillment.

create_checkout destructive

Create a Stripe-hosted checkout session for a product. Returns a checkout_url — the assistant should direct the user to open this URL in their browser to complete payment. License keys are delivered by email immediately after payment.

Returns: { checkout_url, session_id, expires_at, instructions }

get_order_status readOnly

Check the status of an existing order by session ID or order ID.

Returns: { found, status, product_sku, buyer_email, completed_at, provisioned }

04 —

Resources

convertrails://catalog

The full product catalog as a JSON resource — all active merchants and their products. Returns up to 300 products. Response includes total, returned, and truncated flags.

{
  "products": [
    {
      "merchant_id": "acme-corp",
      "seller": "acme",
      "sku": "pro-license",
      "name": "Acme Pro License",
      "price_cents": 4900,
      "currency": "EUR",
      "type": "one_time"
    }
  ],
  "total": 42,
  "returned": 42,
  "truncated": false,
  "generated_at": "2026-03-24T10:00:00.000Z"
}

05 —

Prompts

06 —

Setup instructions

Claude.ai

1. Open claude.ai → Settings → Integrations → MCP Servers
2. Click Add server and enter: https://mcp.convertrails.com
3. Claude will auto-discover tools. No further configuration needed.
4. In any conversation: "search ConvertRails for [product type]"

Claude Code (CLI)

claude mcp add convertrails https://mcp.convertrails.com

Claude Desktop (JSON config)

{
  "mcpServers": {
    "convertrails": {
      "url": "https://mcp.convertrails.com/mcp"
    }
  }
}

GitHub Copilot (VS Code / JetBrains / Visual Studio)

Requires Copilot Business or Copilot Enterprise. Your organization must have "MCP servers in Copilot" policy enabled.

Add to your VS Code settings.json or repository .github/copilot/mcp.json:

{
  "servers": {
    "convertrails": {
      "url": "https://mcp.convertrails.com",
      "type": "http"
    }
  }
}

For the Copilot coding agent, use a repository-level config at .github/copilot/mcp.json. OAuth-based auth is supported for Copilot Chat; the coding agent requires no-auth or PAT configurations.

Microsoft 365 Copilot (Declarative Agent)

Use the ConvertRails plugin manifest to connect as a declarative agent extension:

https://convertrails.com/plugin-manifest.json

In your agent manifest, add a runtime entry:

{
  "runtimes": [{
    "type": "RemoteMCPServer",
    "spec": {
      "url": "https://mcp.convertrails.com"
    },
    "auth": { "type": "OAuthPluginVault" }
  }]
}

Note: Microsoft Security Copilot only imports read-only tools (search_products, get_product, get_order_status). The create_checkout tool is excluded from Security Copilot per Microsoft's policy for destructive tools.

npx bridge (for stdio-only clients)

npx @convertrails/mcp

07 —

Worked examples

search_products({ "query": "markdown editor CLI", "limit": 5 })

{
  "results": [{
    "merchant_id": "indie-dev-42",
    "sku": "mdx-pro",
    "name": "MDX Pro — Markdown CLI",
    "description": "Fast terminal-based markdown editor with live preview",
    "price": "€12.00",
    "currency": "EUR",
    "type": "one_time"
  }],
  "total": 1,
  "hint": "Found 1 product(s). Use create_checkout with merchant_id and sku to purchase."
}

create_checkout({
  "merchant_id": "indie-dev-42",
  "sku": "mdx-pro",
  "buyer_email": "user@example.com"
})

{
  "session_id": "cs_live_a1B2c3D4e5F6...",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1B2c3...",
  "expires_at": "2026-03-24T10:30:00.000Z",
  "instructions": "Open the checkout link to complete payment. Your license key will be emailed to user@example.com immediately after payment."
}

search_products({ "query": "developer tools", "limit": 10 })

08 —

Error handling

All errors follow JSON-RPC 2.0 error format. Tool errors are returned as successful JSON-RPC responses with isError: true in the result so the assistant can read and relay the message to the user.

09 —

Privacy & compliance

• Data controller: 4point1 GmbH, 77815 Bühl, Germany
• GDPR compliant — EU-based hosting (Hetzner, Germany)
• We do not receive or log the content of Claude conversations
• Tool call metadata (tool name, timestamps, success/error) is retained for 180 days
• Buyer email and purchase records are retained for 7 years (tax requirements)

Full privacy policy: convertrails.com/datenschutz
Support & questions: steffen@convertrails.com