# Bipa

> Payments for AI agents. Your agent pays. You approve with biometrics.

Bipa gives AI agents purchasing power over PIX (Brazil's instant payment network) with human-gated consent via the Bipa mobile app.

## MCP Server

- Remote: `https://mcp.bipa.app/mcp`
- Local: `bipa mcp serve --stdio` (requires CLI)
- Auth: OAuth 2.1 with PKCE (remote) or browser login (local)
- Discovery: `https://mcp.bipa.app/.well-known/oauth-authorization-server`

## Available MCP Tools

### Payments
- `bipa_pay` — Send a PIX transfer (supports scheduling)
- `bipa_pix_pay_key` — Pay via Pix key. Returns awaiting_approval status — user approves in the Bipa app.
- `bipa_pix_pay_brcode` — Pay via BR Code
- `bipa_pix_pay_tag` — Pay a Bipa user by tag
- `bipa_pix_pay_trusted_contact` — Pay a trusted contact
- `bipa_pix_pay_recipient` — Pay a saved recipient by ID (from bipa_pix_recipient_suggestions)

### Payment Previews
- `bipa_pix_brcode_decode` — Decode a PIX BR Code payload
- `bipa_pix_brcode_preview` — Preview a BR Code payment before paying
- `bipa_pix_tag_preview` — Look up a Bipa user by tag

### Contacts & Recipients
- `bipa_pix_keys` — List Pix keys
- `bipa_pix_trusted_contacts` — List trusted contacts
- `bipa_pix_recipient_suggestions` — Suggest recent recipients. Call this first when paying someone by name.

### History & Transactions
- `bipa_history` — Transaction history
- `bipa_transactions` — Multi-asset transaction list
- `bipa_transaction_detail` — Detail of a specific transaction
- `bipa_timeline` — Unified activity timeline

### Market Data
- `bipa_tickers` — Current BTC/USDT prices
- `bipa_btc_prices` — BTC/BRL price history
- `bipa_usdt_prices` — USDT/BRL price history
- `bipa_portfolio` — Portfolio summary by asset and period

### Account
- `bipa_balance` — Check all wallet balances
- `bipa_account` — Account profile
- `bipa_limits` — Check spending limits
- `bipa_deposit` — Get deposit addresses
- `bipa_whoami` — Current session info

## Integration Guides

- [Bipa for Agents](/): Landing page — what the product is, who it's for, demo
- [Docs index](/docs): Top-level documentation entry point with platform list
- [Claude (overview)](/docs/claude): Umbrella page for all Claude surfaces (Desktop, Code, .ai)
- [Full docs](/llms-full.txt): Complete integration guide for all platforms
- [MCP Overview](/docs/mcp): What is Model Context Protocol, how Bipa's MCP server works, FAQ
- [Security](/docs/seguranca): How Bipa keeps money safe when AI agents pay — passkey, biometric approval, audit log
- [n8n](/docs/n8n): MCP Client Tool node setup and example financial-agent workflow
- [Claude Desktop](/docs/claude-desktop): Local + Remote MCP
- [Claude.ai](/docs/claude-ai): Remote MCP via Connectors
- [Claude Code](/docs/claude-code): CLI `claude mcp add`
- [Codex](/docs/codex): Settings UI or YAML config
- [Cursor](/docs/cursor): `.cursor/mcp.json` or deep link
- [ChatGPT](/docs/chatgpt): Settings > Apps & Connectors > Create
- [VS Code](/docs/vscode): `.vscode/mcp.json` with Copilot
- [Windsurf](/docs/windsurf): `~/.codeium/windsurf/mcp_config.json`
- [Gemini](/docs/gemini): Gemini Extensions
- [Grok](/docs/grok): Grok MCP settings
- [Replit](/docs/replit): Replit Agent MCP
- [Lovable](/docs/lovable): Lovable MCP integration
- [Antigravity](/docs/antigravity): Antigravity MCP
- [OpenClaw](/docs/openclaw): Shell agent — installs and drives the bipa CLI directly

## Quick Start

Remote (no install):
```
Server URL: https://mcp.bipa.app/mcp
```

Local (preferred for agents):
```bash
curl -fsSL https://agents.bipa.app/install.sh | sh
bipa login
bipa mcp serve --stdio
```

Developer-only package-manager installs are also available in the main docs, but agents should prefer the managed installer.

## Pricing

Free. No additional fees.