Developer Portal

Chat App Setup

Connect Claude or OpenAI products to Admetrics analytics in a few minutes. Every setup below uses the same MCP URL — copy it once and paste it into the client you use.

MCP URL

MCP URL
https://api.admetrics.io/mcp

Prefer OAuth sign-in wherever the client supports it. Use a static API token from API Access only when OAuth is unavailable.

Claude

  1. Open Settings → Connectors.
  2. Choose Add custom connector.
  3. Paste the MCP URL from above and save.
  4. When prompted, sign in with OAuth and approve access.
  5. Enable the connector in a chat and ask a question, for example: "Which analytics clients can I access?"

Claude Code (CLI)

  1. Add the server and sign in:
claude mcp add --transport http admetrics \
  https://api.admetrics.io/mcp

claude mcp login admetrics
  1. Start claude and ask an analytics question — the Admetrics tools are available automatically.

ChatGPT

  1. Open Settings → Connectors (requires a plan with custom connectors enabled).
  2. Choose Create and paste the MCP URL from above.
  3. Select OAuth as the authentication method and finish the sign-in.
  4. Enable the connector in a conversation and ask a question, for example: "Show my spend by channel for last week."

Codex

  1. Create a token in API Access and export it:
export AQL_BEARER_TOKEN="<your-token>"
  1. Add the server to ~/.codex/config.toml:
[mcp_servers.admetrics]
url = "https://api.admetrics.io/mcp"
bearer_token_env_var = "AQL_BEARER_TOKEN"
tool_timeout_sec = 180
  1. Start Codex and ask an analytics question.

Verify the connection

Ask the model: "List the analytics clients I can access." A working setup calls the Admetrics client-listing tool and returns your workspace clients. If the call fails with 401, re-run the OAuth sign-in or renew the token.