Skip to main content

Quickstart

Get up and running with Walleot in a few minutes.

Choose your integration​

Building an MCP server? → Use the SDK examples below for automatic per-call pricing.

Need direct payment links? → Use the REST API examples for manual payment flows.

Not sure? → Start with the MCP SDK approach below—it's simpler.

1) Get API keys​

  1. Sign in to your Walleot dashboard
  2. Create a new merchant account, or switch to an existing one.
  3. Create a Test API key.
  4. Store it as an environment variable (never commit secrets):
export WALLEOT_API_KEY="sk_test_..."

2) Install an SDK​

Choose your language:

Python
pip install walleot
Node
npm install walleot
# or: pnpm add walleot

3) Add Walleot to your MCP server​

import { Server } from "@modelcontextprotocol/sdk/server";
import { installWalleot, Mode } from "walleot";
import { z } from "zod";

const server = new Server({ name: "my-server", version: "0.0.1" });

installWalleot(server, {
  apiKey: process.env.WALLEOT_API_KEY!
});

server.registerTool(
  "add",
  {
    title: "Add",
    description: "Add two numbers.",
    inputSchema: { a: z.number(), b: z.number() },
    price: { amount: 0.19, currency: "USD" }, // $0.19
  },
  async ({ a, b }, extra) => {
    return { content: [{ type: "text", text: String(a + b) }] };
  }
);

4) What users experience​

  • The MCP server receives a request to call your tool. Walleot intercepts this request and generates a payment link.
  • For a new user: Walleot handles a simple 2‑click registration via the link.
  • For a returning user:
    • Small charges are approved automatically (based on the user’s limits, coming soon).
    • Larger charges trigger a one‑tap approval link sent to the user.
  • After approval, the tool runs and returns the result back to the client.

Next steps​

For MCP servers:

For direct API integration: