MCP server

WAVE speaks the Model Context Protocol two ways. The hosted endpoint at https://api.wave.online/mcp needs no install: a client posts JSON-RPC to it and every tool calls the same gateway route a person calls with an API key. The local server, @wave-av/mcp-server, runs on your machine over stdio for clients that cannot reach a remote endpoint.

Hosted endpoint

tools/list needs no key. tools/call carries the key in the Authorization header.

curl -s -X POST https://api.wave.online/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -s -X POST https://api.wave.online/mcp \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"wave_engine_capabilities","arguments":{}}}'

Measured 2026-09-12: tools/list answers 96 tools and initialize reports server wave-mcp. Every tool, with its own call, is on the MCP tools page.

A remote-server entry in your client config:

{
  "mcpServers": {
    "wave": {
      "url": "https://api.wave.online/mcp",
      "headers": { "Authorization": "Bearer wave_sk_live_…" }
    }
  }
}

Local server

The stdio server is published as @wave-av/mcp-server (open source).

npx @wave-av/mcp-server

{
  "mcpServers": {
    "wave": {
      "command": "npx",
      "args": ["@wave-av/mcp-server"],
      "env": { "WAVE_API_KEY": "wave_sk_live_…" }
    }
  }
}

Get a key from console.wave.online. Access is enforced at the gateway: the key's scopes decide what the tools can do.

What a tool answers

A tool result carries the gateway's answer for the route it called.

• 2xx: the payload.
• 402: the route is priced; the body carries the x402 terms and an agent pays per call.
• 403 SCOPE_INSUFFICIENT: the route is live and the key lacks the scope named in required_scope.
• 404: the id is unknown.

For agents

Autonomous agents read the machine descriptors directly:

• MCP descriptor: /.well-known/mcp
• x402 discovery: /.well-known/x402
• Agent skill: /skill.md · Capability index: /llms.txt

Agent commerce is not a separate product: every WAVE capability is callable by people and payable by agents over HTTP 402 (x402).