Claude Code

Anthropic's CLI agent supports MCP natively. Add the Bipa Agents server with a single command.

Local (stdio) Remote (HTTP + OAuth)

Prerequisites

A Bipa account with an active registration.
Claude Code installed (npm i -g @anthropic-ai/claude-code).
bipa CLI installed (for local mode).

Local Setup (stdio)

Add the local MCP server

Run the following command in your terminal. Use --scope project to save in .mcp.json (project-level) or --scope user for global config in ~/.claude.json.

claude mcp add bipa -- bipa mcp serve --stdio

Verify the connection

Start a Claude Code session and check the available MCP tools:

claude
# Then in the session, ask:
# "What MCP tools are available?"

Make sure you have run bipa login --web --open (or bipa login --web and open the URL yourself) before adding the server.

Remote Setup (HTTP + OAuth)

Connect directly to the Bipa Agents remote MCP server. No local installation required. Authentication is handled via OAuth 2.1 with PKCE.

Add the remote MCP server

Run the following command in your terminal:

claude mcp add --transport http bipa https://mcp.bipa.app/mcp

Authenticate

The first time you use a Bipa Agents tool, Claude Code will open your browser to complete the OAuth flow with Bipa. After authorization, the token is cached automatically.

Available MCP Tools

Once connected, the following tools become available to the AI assistant:

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

How Authentication Works

Local mode: The CLI authenticates by opening your browser. You sign in with the Bipa app and the session token is stored locally.

Remote mode: The MCP client handles OAuth 2.1 automatically. It discovers endpoints via /.well-known/oauth-authorization-server, redirects you to the Bipa app for authorization, and exchanges the code for an access token using PKCE.