# Partnr — Brazilian financial data

Brazilian market data as MCP tools: B3-listed companies, CVM-registered
funds (FIIs, ETFs, Fiagros, FIDCs), BCB-regulated banks, quotes, indexes,
macroeconomics, news, a stock screener, and a catalogue of every metric
the platform computes. Every tool is read-only.

## Connect

    https://mcp.partnr.ai/mcp

Streamable HTTP. Protocol revision 2026-07-28, with a stateless fallback
for 2025-era clients.

## Authenticate

Add the URL above as a remote MCP server with no credentials. The server
answers 401 with a pointer to its authorization metadata, your client
discovers the OAuth flow, and you paste a Partnr API key once in the
browser. The client manages tokens from there, and the key is never
written to a config file.

Headless clients can send the key directly instead:

    X-API-Key: <your key>

Passing it as ?api_key= is deprecated and stops working on 2026-09-30.

## Client configuration

Clients with OAuth support — Claude, ChatGPT — need only the URL. For
the rest:

    {
      "mcpServers": {
        "partnr": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.partnr.ai/mcp",
            "--header",
            "X-API-Key:${PARTNR_API_KEY}"
          ],
          "env": {
            "PARTNR_API_KEY": "<your key>"
          }
        }
      }
    }

Claude Code:

    claude mcp add --transport http partnr https://mcp.partnr.ai/mcp

## Finding your way around

Once connected, read the partnr://docs resource for an index of every
tool, and partnr://docs/<tool> for one tool's reference: what it
returns, how to name the entity, and the mistakes that produce empty
results.

Two tools worth calling first. `whoami` reports what your key can
reach, so you find out before a call fails. `concepts_search` turns a
financial idea into the ID that fetches it, and tells you whether that
ID is a ratio or a statement line item — which decides the tool to call.

## More

    Documentation   https://developers.partnr.ai/mcp
    Get a key       https://partnr.ai/contato
    Health          https://mcp.partnr.ai/health