Connect the agent - Sapiom Pay

Your agent reaches Sapiom’s payment tools through a hosted MCP server at https://api.sapiom.ai/v1/mcp. The key you connect with decides which buyer the agent acts for, so each user’s session needs its own connection with that user’s buyer key.

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"),
    { 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 buyer, add the server to a client such as Claude Code:

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

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