mayi

The agent proposes. Your rules decide.

Website and live demo · PyPI · Guide

mayi (as in "may I?") enforces who controls each argument of an AI agent's tool call. Permissions usually say which tool an agent may call. They do not say which value it may pass, so refund(40) and refund(9000) look the same. mayi sits between the agent and your tools and gives every argument one owner:

The rules are plain code. There is no second model judging the first. Anything not in the catalog is rejected.

Try it

pip install mayi
mayi demo

Open the console at http://127.0.0.1:8787/console (key: demo-app-key). To watch a real Claude model get a hidden attack, run mayi try-model in a second window with ANTHROPIC_API_KEY set.

Use it with your own tools

mayi init                  # writes catalog.yaml and tools.json
mayi check catalog.yaml    # validate your rules
mayi serve                 # prints an agent key and an app key

Edit catalog.yaml to say who controls each argument. Your app opens a session with the values it controls; the agent calls POST /v1/call; held calls wait in the console for a person. Budgets total per session by default; pass budget_key (a customer id, say) when your app opens a session to total over a customer instead. More in the guide.

Results

The replayed tests measure what happens after a fooled agent proposes the call, not how often models are fooled. The live test used two models and eight injections written by the author. Details, including where it did not help, are in the guide.

Works with

Tested: the official MCP Python client (SDK 1.30 and 2.2) through mayi mcp-proxy, the OpenAI Agents SDK, CrewAI, LangGraph and the Anthropic SDK. Not yet tested: Claude Desktop, Claude Code, Cursor and other MCP hosts. Reports from people who try them are welcome.

What is included

• Gateway with an audit log and a console; MCP proxy that puts any MCP server behind the same rules
• Single-use approvals signed with HMAC or Ed25519, two-person approval, session budgets, rate limits
• mayi prove to check a catalog for broken invariants, with counterexamples
• Adapters for the OpenAI Agents SDK and CrewAI, and a TypeScript client

Limits

• No outside security review yet. Do not use mayi alone to protect tools that move money.
• It checks free text the model writes but does not judge what it means.
• The copied-value check is a heuristic. Paraphrased, translated or spelled-out values get through.
• It is not a new idea. Progent and CaMeL came first; the guide compares them.

If mayi is useful

A star on GitHub helps other people find it. If you try it with a host or framework that is not listed above, please open an issue and say what worked and what broke.

Run the tests

pip install pytest hypothesis && python3 -m pytest -q

Contributing and security

See CONTRIBUTING.md and the roadmap. To report a vulnerability, read SECURITY.md.

License

Apache-2.0. See LICENSE.