Sign up

Connect remote MCP

How to connect Cursor, Claude or other MCP clients to the zahls.ch remote MCP endpoint.

With zahls.ch remote MCP, you can connect AI clients such as Cursor or Claude directly to your zahls.ch API. The tools map to OpenAPI operations and are proxied server-side to the REST API.

Product overview: Remote MCP.

Prerequisites

  1. An active zahls.ch account
  2. An API key from the dashboard under API and Integrations
  3. Your instance name — the first part of your URL. For example.zahls.ch, the instance is example.

Endpoint and authentication

Endpointhttps://www.zahls.ch/mcp
HeaderX-API-KEY — your API key
HeaderX-Instance — your instance name (without .zahls.ch)

Without both headers, the endpoint responds with 401.

Connect Cursor

Add an MCP server in your project or user config (for example .cursor/mcp.json or the Cursor MCP settings):

{
  "mcpServers": {
    "zahls-ch": {
      "url": "https://www.zahls.ch/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY",
        "X-Instance": "your-instance"
      }
    }
  }
}

Replace the placeholders, save the file, and restart the MCP server in Cursor. The zahls.ch tools should then appear in the tool list.

Other MCP clients

Any client that supports remote MCP (HTTP) with custom request headers can use the same endpoint:

  • URL: https://www.zahls.ch/mcp
  • Headers X-API-KEY and X-Instance as above

Exact config syntax depends on the client — what matters is the endpoint and both headers.

What the tools can do

MCP exposes the documented API operations as tools, for example:

  • Create and manage payment links
  • Create invoices and donations
  • Query transactions and payment status
  • Manage subscriptions and initiate refunds

Exact tool names and parameters come from the zahls.ch OpenAPI specification.

Safe usage

  • Use a dedicated API key for the MCP client so you can rotate it if needed.
  • Restrict high-risk actions (large amounts, refunds) in your prompts or require human confirmation.
  • For asynchronous status updates, still set up webhooks — MCP does not replace webhooks in every case.

Next steps

Related