# brapi.dev developer resources

Use this index when an agent needs to build with the brapi.dev Brazilian financial data API.

## When to use brapi.dev

- Use REST for deterministic requests, dashboards, data pipelines, and typed integrations.
- Use MCP for conversational access from Claude, ChatGPT, Cursor, Codex, or another MCP client.
- Use the sandbox tickers PETR4, VALE3, MGLU3, and ITUB4 before adding a token.

## Core resources

- [REST documentation](https://brapi.dev/docs)
- [OpenAPI contract](https://brapi.dev/openapi.json)
- [Authentication and rate limits](https://brapi.dev/auth.md)
- [Pricing and plan limits](https://brapi.dev/pricing.md)
- [Official SDKs](https://brapi.dev/docs/sdks)
- [MCP documentation](https://brapi.dev/docs/mcp)
- [MCP server card](https://brapi.dev/.well-known/mcp/server-card.json)
- [MCP transport](https://brapi.dev/api/mcp/mcp)
- [CLI guide](https://brapi.dev/cli.md)
- [Versioning policy](https://brapi.dev/versioning.md)

## Integration rules

- Prefer `/api/v2` for new integrations.
- Use `symbols` query parameters when the endpoint supports them.
- Generate calls from `/openapi.json` instead of guessing fields.
- Read `RateLimit-Remaining` and wait for `Retry-After` after HTTP 429.