Quickstart

Three steps: create a key, connect a client, call a tool. You need a verified Oumafy passport — complete your passport at oumafy.com and verification is automatic.

1 · Create a key

Sign in at oumafy.com and open Settings → Agent MCP Keys (also reachable from your passport's ⋮ menu, or directly at oumafy.com/settings/keys). Give the key a label, pick a scope — read or full — and create it.

The key looks like oum_live_… and is shown exactly once. Oumafy stores only a hash of it and cannot show it again. If you lose it, revoke it and create a new one. You can hold up to five active keys.

2 · Connect a client

With Claude Code, one command:

claude mcp add --transport http oumafy https://mcp.oumafy.com/mcp \
  --header "Authorization: Bearer oum_live_…"

With any other MCP client, add a remote HTTP server with the address https://mcp.oumafy.com/mcp and the header Authorization: Bearer <your key>. A typical JSON configuration:

{
  "mcpServers": {
    "oumafy": {
      "type": "http",
      "url": "https://mcp.oumafy.com/mcp",
      "headers": {
        "Authorization": "Bearer oum_live_…"
      }
    }
  }
}

3 · Make a first call

Ask your agent something that needs the network — “what can I still vote on?” or “show my passport.” Or verify the connection by hand with curl:

curl -s -X POST https://mcp.oumafy.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H "Authorization: Bearer oum_live_…" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A read-only key lists 8 tools; a full key lists 13. If you get a 401, the key is wrong, revoked, or your passport is no longer verified — see limits & errors.

Next

Browse the tool reference to see what each tool takes and returns, and read keys & scopes before you hand a full-scope key to a long-running agent.