# Shotoku

> Shotoku is an open-source agent framework for finance and payments. Local spend limits, approvals and audit trail for AI agent payments. It is available on CLI, self-hosted, API, telegram and Slack.

- **Kind:** Agent
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API, telegram, Slack
- **Website:** https://www.shotoku.dev
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The README-style site copy frames Shotoku as a gate that decides whether an agent's spend is allowed before any payment runs. Budgets are set per agent and per vendor in a single YAML policy file, with per-transaction and rolling 24-hour caps. When a request is over a limit it is either denied or held in a queue for a human to approve, so small refunds can pass while large charges wait.

Shotoku runs on your own machine with no account or cloud component. Every decision, whether approved, denied or pending, is appended to a local JSONL file you can read, move or delete. Approvals can go to Telegram with buttons, or be handled in a local dashboard or terminal UI. In MCP wrapping mode it sits in front of other MCP servers, such as PayPal's, so tool calls are checked before they reach them.

It is aimed at developers building agents that make purchases or payments. It does not hold funds, store credentials or execute payments; the agent's own wallet or payment rail does that. The project is in beta and open source at its core, with paid team and enterprise tiers described on the pricing page.

## Features

- **Per-vendor spending limits:** Caps each transaction and a rolling 24-hour total for every vendor, plus a daily budget per agent.
- **Human approval queue:** Requests over a limit can be held as pending until a person approves or denies them.
- **Local decision ledger:** Every authorization decision is written to a plain JSONL file on your machine.
- **Policy as YAML config:** Budgets and rules are defined in one YAML file instead of application code.
- **MCP server wrapping:** Places Shotoku in front of an agent's other MCP servers so each tool call is decided first.
- **Telegram approvals:** Sends pending decisions to Telegram with approve and deny buttons, accepting only the owner's taps.

## Good for

- Limit how much an autonomous purchasing agent can spend per vendor each day
- Route large agent payments to a person for approval before they execute
- Keep a local, inspectable audit trail of every agent spending decision
- Enforce spending rules on agents that call PayPal or other MCP payment tools

## FAQ

### Does Shotoku process or hold payments?

No. The site says Shotoku holds no funds, stores no credentials or private keys, and never signs or settles a payment. It only decides whether a spend is allowed and records the decision.

### Does it require an account or cloud service?

The site says it runs entirely on your machine with no account, no cloud and no telemetry.

### What is the current stage of the project?

The site describes Shotoku as in beta, with the core authorization path tested and running end to end against PayPal's sandbox.

### Is the core free?

The pricing page says the core authorization engine is open source and free to run on your machine. Team and Enterprise tiers add shared control and governance features.

### Is Shotoku free?

Yes. Shotoku is open source, so you can use and self-host it for free.

## Where this comes from

- Description: written from the project's website.

## Alternatives

- [Senpi AI](https://ai-powered.com/agents/senpi-ai): Senpi AI is a freemium hosted agent for finance and payments.

---
Source: https://ai-powered.com/agents/shotoku
