Give your agent tools it can pay for.

{
  "mcpServers": {
    "routavo": {
      "type": "http",
      "url": "https://routavo.com/api/mcp"
    }
  }
}

In mcp.json, .cursor/mcp.json or your client's equivalent. To pay from a balance, add "headers": {"Authorization": "Bearer rw_..."} beside "url", with your Routavo key.

import { experimental_createMCPClient as createMCPClient } from 'ai';

const routavo = await createMCPClient({
  transport: { type: 'http', url: 'https://routavo.com/api/mcp' }
});

const { text } = await generateText({
  model: openai('gpt-5'),
  tools: await routavo.tools(),
  prompt: 'Where is Reykjavik? Use a geocoding API.'
});

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "routavo": {"url": "https://routavo.com/api/mcp", "transport": "streamable_http"}
})
tools = await client.get_tools()

agent = create_agent(model, tools=tools)

import { Agent, MCPServerStreamableHttp } from '@openai/agents';

const routavo = new MCPServerStreamableHttp({
  url: 'https://routavo.com/api/mcp',
  name: 'Routavo'
});

const agent = new Agent({ name: 'Assistant', mcpServers: [routavo] });

// POST https://api.x.ai/v1/responses (or /chat/completions)
{
  "model": "grok-4.6",
  "tools": [{
    "type": "mcp",
    "server_url": "https://routavo.com/api/mcp",
    "server_label": "routavo",
    "allowed_tools": ["discover", "call"],
    // leave this out for the free tier; a key from /topup pays from a balance
    "authorization": "rw_..."
  }],
  "input": "What is the forecast in Oslo tomorrow? Use Routavo."
}

# what can it do
curl -s https://routavo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'mcp-protocol-version: 2026-07-28' \
  -H 'mcp-method: tools/call' -H 'mcp-name: discover' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"discover","arguments":{}}}'

# call something
curl -s https://routavo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'mcp-protocol-version: 2026-07-28' \
  -H 'mcp-method: tools/call' -H 'mcp-name: call' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"call","arguments":{
         "capability":"geocode","arguments":{"query":"Reykjavik"}}}}'