Connect your agent

The gateway in front of Valio Aimo is open. Any agent can read how it works, connect over MCP and order within a customer's signed limits. Every price it quotes is signed, so you can check one yourself without trusting us.

What the gateway publishes

Discovery documentWhere an agent starts: the addresses below, how long an offer holds and the order rules./.well-known/agent-interface.json
API descriptionEvery route with its request and response, as OpenAPI. Browse it, or generate a client from it./docs openapi.json
JSON SchemasOne schema for each object an agent sends or gets back: the permission slip, the offer, the order./schemas
Public keysThe keys that sign offers and order confirmations. Use them to check any offer, as below./.well-known/jwks.json

Check an offer yourself

Paste a signed offer from a quote or from your agent. This page checks its signature against the public keys, here in your browser; the offer isn't sent anywhere.

Signed offer

Paste an offer, or use the sample. The result shows who signed it, until when it holds and its fingerprint.

Connect Claude over MCP

Run these from the repository root while the gateway runs. The wallet is a small local MCP server: it holds the customer's permission slip and key and signs every call, so your AI never sees the key.

1
Register a demo customer for your agent. Once is enough.
```
uv run python -m gateway.second_agent_demo --register-demo-kitchen
```

Add the gateway's tools to Claude Code.

claude mcp add aimo -- uv run python -m gateway.agent_wallet --slip secrets/demo-agent/slip.jws --agent-key secrets/demo-agent/agent.pem --gateway http://localhost:8001

3
Ask Claude for a quote, for example:
“Using the aimo tools, find lactose-free milk and quote 1,000 litres for next Monday. Check it against our policy, but don't place the order.”

Code that holds its own key can call http://localhost:8001/mcp directly. Claude Desktop and the signing details are in gateway/MCP.md.