Connect the agent

Your agent reaches Sapiom’s payment tools through a hosted MCP server at https://api.sapiom.ai/v1/mcp/pay. The key you connect with decides which user the agent acts for, so each user’s session needs its own connection with that user’s key. The server takes the key in an x-api-key header, so your MCP client must be able to send one. It lists only the eight payment tools in MCP tools. Existing connections to https://api.sapiom.ai/v1/mcp keep working. Browser checkout also needs a browser worker running Browser Pay.

Connect in your agent’s code

Open the connection when a session starts, with the key of the user you are serving. This example uses the TypeScript MCP SDK:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

export async function connectSapiom(buyerKey: string) {
  const transport = new StreamableHTTPClientTransport(
    new URL("https://api.sapiom.ai/v1/mcp/pay"),
    { requestInit: { headers: { "x-api-key": buyerKey } } },
  );
  const client = new Client({ name: "your-agent", version: "1.0.0" });
  await client.connect(transport);
  return client;
}

Close the connection when the session ends. Never share one connection between users.

Connect a client for testing

To try the tools by hand as one test user, add the server to a client such as Claude Code:

claude mcp add --transport http sapiom https://api.sapiom.ai/v1/mcp/pay \
  --header "x-api-key: $SAPIOM_BUYER_KEY"

Ask: “List my saved Sapiom cards.” The agent calls sapiom_list_payment_methods and returns that user’s cards. All tools are listed in the MCP tools reference.

Get started

Users

Cards

Transactions

Governance

Security

Early access

Connect in your agent’s code

Connect a client for testing

​Connect in your agent’s code

​Connect a client for testing

Connect in your agent’s code

Connect a client for testing