walleot

Accept payments in your MCP agents in just two lines of code using Walleot — a drop-in payment provider built for the Model Context Protocol.

Overview

This is a lightweight wrapper around paymcp that configures it to use Walleot as the payment backend, so you can start charging for tool usage with minimal effort.

Installation

npm install walleot
# or
pnpm add walleot
# or
yarn add walleot

Usage

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: "YOUR WALLEOT API KEY",
  mode: Mode.ELICITATION, // or TWO_STEP / RESUBMIT /  PROGRESS / ELICITATION / DYNAMIC_TOOLS
});

server.registerTool(
  "add",
  {
    title: "Add",
    description: "Add two numbers. ",
    inputSchema: {
      a: z.number(),
      b: z.number(),
    },
    price: { amount: 0.19, currency: "USD" },
  },
  async ({ a, b }, extra) => {
    // `extra` is required by the PayMCP tool signature — include it even if unused
    return {
      content: [{ type: "text", text: String(a + b) }],
    };
  }
);

Features

• Accept payments of any amount, including microtransactions as small as $0.01
• Add monetization to any MCP tool
• Supports multiple mode (two_step, resubmit, elicit, progress, dynamic_tools)
• Secure API-key-based authentication

Getting Started

1. Visit https://walleot.com
2. Create an account and register a new merchant
3. Generate your API key and use it in your MCP server

Built on top of paymcp