Cursor

AI-first code editor with native MCP support. Add Bipa Agents via settings, a project config file, or the one-click deep link.

Local (stdio) Remote (HTTP + OAuth)

Quick Connect

Add to Cursor (local)

Prerequisites

A Bipa account with an active registration.
Cursor version 0.45 or later.
bipa CLI installed (for local mode).

Local Setup (stdio)

Open Cursor Settings

Open Cursor Settings (not VS Code settings) → navigate to the MCP section. Click Add new MCP server.

Configure the server

Choose stdio transport and enter the command. Alternatively, create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "bipa": {
      "command": "bipa",
      "args": ["mcp", "serve", "--stdio"]
    }
  }
}

Enable the server

After adding, the server appears in the MCP settings panel. Make sure the toggle is enabled (green). Cursor will connect automatically.

Use the Composer (Agent mode) or Chat to interact with MCP tools.

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 remote server via settings

Open Cursor Settings → MCP → Add new MCP server. Choose HTTP transport and enter the URL.

Or use a project config file

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "bipa": {
      "url": "https://mcp.bipa.app/mcp"
    }
  }
}

Authenticate

Cursor will handle the OAuth 2.1 flow automatically. You will be redirected to the Bipa app to authorize access.

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.