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

pip install walleot

Usage

from mcp.server.fastmcp import FastMCP, Context
from walleot import Walleot, price, Mode
import os

mcp = FastMCP("My Server")

walleot = Walleot(
    mcp,
    apiKey=os.getenv("WALLEOT_API_KEY"),
    mode=Mode.ELICITATION
)

@walleot.price(0.99, currency="USD")
@mcp.tool()
def add(a: int, b: int, ctx: Context) -> int:
    # `ctx` is required by the PayMCP tool signature — include it even if unused
    return a + b

Features

• Accept payments of any amount, including microtransactions as small as $0.01
• Add monetization to any tool with a simple decorator
• Supports multiple modes (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