Integration Guides

Connect Your
AI Agent

Bipa Agents exposes its financial tools via the Model Context Protocol (MCP). Connect locally by installing the CLI, or use the remote server at https://mcp.bipa.app/mcp with automatic OAuth 2.1 authentication.

Option A

Local (stdio)

Install the bipa CLI and run the MCP server locally. Best for development, desktop tools, and AI agents that should stay on the managed install path.

Prefer the managed installer for users and agents
Session token stored locally after browser login
Works with all MCP-capable clients
Option B

Remote (HTTP)

Point your client to the remote MCP server. No local install needed. OAuth 2.1 with PKCE handles authentication automatically.

Server URL: https://mcp.bipa.app/mcp
OAuth discovery at /.well-known/oauth-authorization-server
Works with Claude.ai, ChatGPT, and other remote-capable clients
Install the CLI

Managed installer

Recommended for end users and AI agents. This is the default install path for the managed CLI experience.

curl -fsSL https://agents.bipa.app/install.sh | sh

After installing, run bipa login --web --open to authenticate with your Bipa account. Agents can use bipa login --web to get the URL without auto-opening the browser, or bipa login --pin --email <EMAIL> for PIN-based login.

Alternative install

For developers who prefer Cargo:

Cargo
cargo install bipa

Choose Your Platform

MCP Tools Reference

These tools are available to any connected AI assistant once authenticated:

bipa_pix_pay_key

Pay for any service or API

bipa_balance

Check all wallet balances

bipa_history

Transaction history

bipa_deposit

Get deposit addresses

bipa_pix_keys

List Pix keys

bipa_pix_brcode_decode

Decode a Pix BR Code

bipa_limits

Check spending limits

bipa_account

Account profile

bipa_whoami

Current session info

bipa_ln_pay

Pay Lightning invoice

bipa_card_create

Create virtual Mastercard