# Servidor MCP para IAs
URL: /docs/mcp.mdx

Conecte a brapi a qualquer assistente de IA com uma única URL. Funciona com Claude, ChatGPT, Cursor, VS Code, n8n e mais de 100 outros clientes.

***

title: Servidor MCP para IAs
description:
Conecte a brapi a qualquer assistente de IA com uma única URL. Funciona
com Claude, ChatGPT, Cursor, VS Code, n8n e mais de 100 outros clientes.
howToSteps:

* name: 'Crie sua conta'
  text: 'Acesse brapi.dev e crie uma conta gratuita.'
* name: 'Adicione o servidor MCP no seu cliente de IA'
  text: 'Cole a URL do servidor brapi nas configurações de MCP do seu cliente.'
* name: 'Faça uma pergunta'
  text: 'Pergunte sobre cotações, FIIs, câmbio ou indicadores em linguagem natural.'
  howToTools:
* 'Cliente de IA com suporte a MCP (Claude, ChatGPT, Cursor, VS Code, n8n, etc.)'
  howToSupplies:
* 'Conta brapi.dev (gratuita)'

***

import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';
import { Card, Cards } from 'fumadocs-ui/components/card';

O servidor MCP da brapi conecta seu assistente de IA aos dados do mercado
financeiro brasileiro. Com uma única URL, sua IA passa a buscar cotações de
ações, FIIs, câmbio, criptomoedas e indicadores econômicos enquanto você
conversa com ela.

## URL do servidor

```text
https://brapi.dev/api/mcp/mcp
```

Essa é a única URL que você precisa. Copie e cole no seu cliente de IA. Na
primeira vez, ele abre o navegador para você fazer login na brapi.

## Configure seu cliente

<Tabs items={['Claude Code', 'Claude Desktop', 'Codex', 'ChatGPT', 'Cursor', 'VS Code', 'n8n', 'Outros']}>
  <Tab value="Claude Code">
    Rode no terminal:

    ```bash
    claude mcp add --transport http brapi https://brapi.dev/api/mcp/mcp
    ```

    O Claude vai abrir o navegador para você fazer login. Pronto.

    Para verificar a instalação:

    ```bash
    claude mcp list
    ```
  </Tab>

  <Tab value="Claude Desktop">
    Abra o arquivo de configuração do Claude:

    * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

    E adicione:

    ```json
    {
      "mcpServers": {
        "brapi": {
          "command": "npx",
          "args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"]
        }
      }
    }
    ```

    Reinicie o Claude. Na primeira pergunta, ele abre o navegador para você fazer
    login na brapi.
  </Tab>

  <Tab value="Codex">
    Rode no terminal para adicionar o servidor:

    ```bash
    codex mcp add brapi --url https://brapi.dev/api/mcp/mcp
    ```

    Em seguida, faça o login com OAuth:

    ```bash
    codex mcp login brapi
    ```

    O Codex abre o navegador para você fazer login na brapi.

    <Callout type="info">
      Se o Codex disser que não suporta servidores HTTP, abra `~/.codex/config.toml`
      e adicione:

      ```toml
      [features]
      experimental_use_rmcp_client = true
      ```

      Isso ativa o cliente de MCP HTTP do Codex.
    </Callout>
  </Tab>

  <Tab value="ChatGPT">
    1. Abra **Configurações → Conectores** no ChatGPT
    2. Clique em **Adicionar conector personalizado**
    3. Cole a URL: `https://brapi.dev/api/mcp/mcp`
    4. Faça login na brapi quando o ChatGPT pedir

    <Callout type="info">
      Conectores personalizados estão disponíveis nos planos pagos do ChatGPT (Plus,
      Pro, Business e Enterprise).
    </Callout>
  </Tab>

  <Tab value="Cursor">
    Abra `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (do projeto) e
    adicione:

    ```json
    {
      "mcpServers": {
        "brapi": {
          "command": "npx",
          "args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"]
        }
      }
    }
    ```

    Reinicie o Cursor. Na primeira pergunta, ele abre o navegador para login.
  </Tab>

  <Tab value="VS Code">
    Abra `.vscode/mcp.json` no seu projeto (ou nas configurações do usuário) e
    adicione:

    ```json
    {
      "mcp": {
        "servers": {
          "brapi": {
            "url": "https://brapi.dev/api/mcp/mcp"
          }
        }
      }
    }
    ```

    Você precisa do **VS Code 1.99 ou maior** com a extensão **GitHub Copilot**.
    Habilite `chat.mcp.enabled` nas configurações.
  </Tab>

  <Tab value="n8n">
    1. Adicione um node **AI Agent** no seu workflow
    2. Conecte um node **MCP Client Tool**
    3. Em **Server URL**, cole: `https://brapi.dev/api/mcp/mcp`
    4. Em **Authentication**, escolha **OAuth2**

    Pronto para criar automações como alertas de preço, relatórios diários e
    notificações no Slack/Discord.

    [Documentação oficial do MCP Client Tool no n8n](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.mcpclienttool/)
  </Tab>

  <Tab value="Outros">
    O servidor da brapi funciona com qualquer cliente que suporte MCP, incluindo
    **Windsurf**, **Cline**, **Zed**, **Continue**, **Amazon Q**, **Gemini CLI**,
    **goose** e mais de 100 outros.

    Em qualquer um deles, use a URL:

    ```text
    https://brapi.dev/api/mcp/mcp
    ```

    Se o seu cliente não fizer login automático no navegador, gere um token no
    [dashboard da brapi](https://brapi.dev) e use o cabeçalho:

    ```text
    Authorization: Bearer SEU_TOKEN
    ```
  </Tab>
</Tabs>

## Exemplos de perguntas

```txt
Qual é a cotação atual da PETR4?
```

```txt
Compare PETR4 e VALE3 no último mês
```

```txt
Liste as 5 ações com maior volume de negociação hoje
```

```txt
Quais FIIs do segmento de logística têm o maior dividend yield?
```

```txt
Mostre os rendimentos pagos pelo MXRF11 nos últimos 12 meses
```

```txt
Qual a taxa SELIC hoje e como ela mudou nos últimos 12 meses?
```

```txt
Compare a evolução do IPCA e IGP-M nos últimos 5 anos
```

```txt
Qual o preço do Bitcoin em reais agora?
```

```txt
Quais são os vencimentos de opções disponíveis para PETR4?
```

## Ferramentas disponíveis

A IA tem acesso a 22 ferramentas. As 5 primeiras funcionam sem login; as
demais precisam de uma conta brapi.

### Descoberta (sem login)

| Ferramenta                          | O que faz                                             |
| ----------------------------------- | ----------------------------------------------------- |
| `get_available_stocks`              | Lista ações, FIIs, BDRs e índices brasileiros         |
| `get_available_currencies`          | Lista moedas (USD-BRL, EUR-BRL, etc.)                 |
| `get_available_cryptocurrencies`    | Lista criptomoedas (BTC, ETH, etc.)                   |
| `get_available_inflation_countries` | Lista países com dados de inflação                    |
| `get_macro_series_available`        | Lista séries macroeconômicas (Selic, IPCA, CDI, etc.) |

### Ações, câmbio e criptomoedas

| Ferramenta           | O que faz                                  |
| -------------------- | ------------------------------------------ |
| `get_stock_quotes`   | Cotações e histórico de ações, ETFs e BDRs |
| `get_currency_rates` | Taxas de câmbio em tempo real              |
| `get_crypto_prices`  | Preços de criptomoedas                     |

### Indicadores macroeconômicos

| Ferramenta                | O que faz                                              |
| ------------------------- | ------------------------------------------------------ |
| `get_macro_series`        | Histórico de séries macro (Selic, IPCA, IGP-M, CDI...) |
| `get_macro_series_latest` | Valor mais recente de cada série macro                 |
| `get_inflation_data`      | Dados de inflação (IPCA, IGPM)                         |
| `get_prime_rate_data`     | Taxa SELIC e histórico                                 |

### Fundos imobiliários (FIIs)

| Ferramenta                   | O que faz                                                |
| ---------------------------- | -------------------------------------------------------- |
| `get_fii_list`               | Lista FIIs com filtros por segmento, setor e mandato     |
| `get_fii_indicators`         | Indicadores atuais (P/VP, dividend yield, patrimônio...) |
| `get_fii_indicators_history` | Evolução mensal dos indicadores                          |
| `get_fii_historical`         | Histórico diário de preços (OHLCV)                       |
| `get_fii_reports`            | Relatórios mensais da CVM com composição da carteira     |
| `get_fii_dividends`          | Histórico de rendimentos pagos                           |

### Opções

| Ferramenta               | O que faz                                |
| ------------------------ | ---------------------------------------- |
| `get_option_expirations` | Vencimentos disponíveis de um ativo      |
| `get_option_strikes`     | Strikes disponíveis em um vencimento     |
| `get_option_chain`       | Cadeia de opções de um vencimento        |
| `get_option_historical`  | Histórico diário de uma série específica |

## Limites por plano

As consultas via MCP usam o mesmo limite da API REST.

| Plano        | Requisições/mês | Ideal para                   |
| ------------ | --------------- | ---------------------------- |
| **Gratuito** | 15.000          | Testes e projetos pessoais   |
| **Startup**  | 150.000         | Startups e pequenas empresas |
| **Pro**      | 500.000         | Aplicações de alto volume    |

[Ver todos os planos](https://brapi.dev/pricing)

## Próximos passos

<Cards>
  <Card title="Criar Conta" href="https://brapi.dev" />

  <Card title="Documentação da API" href="/docs" />

  <Card title="Suporte" href="https://brapi.dev/contact" />
</Cards>

***

<Callout type="warn">
  Os dados são fornecidos apenas para fins informativos e não constituem
  aconselhamento financeiro. Consulte sempre um profissional qualificado antes
  de tomar decisões de investimento.
</Callout>