Base MCP Plugin | Umia Docs

Let AI agents discover, analyze, and trade Umia decision markets and bid in token auctions through Base MCP send_calls

Umia ships a Base MCP plugin that lets any AI agent trade decision markets (futarchy) and participate in token auctions. The agent reads public Umia APIs, builds unsigned { to, value, data } calldata via the auth-free /api/v1/calldata/* endpoints (or the npx umia-cli@latest thin client), and submits everything through Base MCP send_calls. It never signs or broadcasts on its own, and never touches a private key.

The canonical plugin file is hosted at:

umia.finance/base-mcp/umia.md

It is authored against the upstream plugin spec and targets skills/base-mcp/plugins/umia.md in base/skills. Until it ships there as a native plugin, install it as a custom plugin:

Install as a custom plugin

Install the Base MCP skill if you haven't: npx skills add base/skills --skill base-mcp.
Download the plugin file and drop it next to the skill's other plugins (skills/base-mcp/plugins/umia.md in your skill directory), or simply paste its contents into the conversation and tell the agent to treat it as a Base MCP plugin:
```
curl -sL https://umia.finance/base-mcp/umia.md \
  -o skills/base-mcp/plugins/umia.md
```
Smoke-test the CLI path: UMIA_ENV=testnet npx umia-cli@latest auctions.

Custom plugins and the web_request allowlist

Custom plugins are not in Base MCP's hosted web_request allowlist. On chat-only surfaces (Claude.ai, ChatGPT) web_request will reject api.testnet.umia.finance / api.mainnet.umia.finance until the plugin ships natively. The consumer-surface user-paste fallback is GET-only, so the POST /api/v1/calldata/* builders cannot run there at all. Use a harness with its own HTTP tools or a shell (Claude Code, Codex, Cursor): the plugin's Surface Routing section prefers those paths automatically.

What agents can do

Markets: list open decision markets, read proposals and TWAP prices, enter (split), buy/sell proposal conviction with quoted price impact, merge back, claim settlements, and permissionlessly settle ended markets.
Auctions: list live fundraises, read clearing price / raised / leaderboard analytics, bid on permissionless steps (with automatic tick-grid price alignment and Permit2 approval batching), and claim. The claim batch composes the required exits first, so unspent-currency refunds and token transfers land in one send_calls.
Verification-gated auction steps (zkTLS / server permit) are detected and routed to the Umia hub UI instead of failing on-chain.

Everything runs on the environment selected by UMIA_ENV. Default testnet (base-sepolia and testnet Base). Mainnet currently hosts auctions only.