AI integration setup

Paisa ships a standalone MCP server (@paisa/mcp) that connects any MCP-compatible AI assistant to your financial data over HTTP. No database connection required — it calls the Paisa API using a Bearer token you generate.

What is MCP?

The Model Context Protocol is an open standard for connecting AI assistants to external tools and data. It’s supported by Claude, Cursor, Windsurf, and other AI clients.

Once connected, your AI assistant gets 63 tools to read and write your Paisa data — transactions, budgets, goals, investments, and more.

Prerequisites

Node.js 20+ or Bun
A Paisa account with an API token (Settings → Integrations → API Tokens)
An MCP-compatible AI client

Install

npm install -g @paisa/mcp
# or
bun add -g @paisa/mcp

Or use it directly from the monorepo:

node /path/to/paisa/packages/mcp/dist/index.js

Configure

claude mcp add paisa -- node $(which paisa-mcp)

Then add your credentials to ~/.claude.json:

{
  "mcpServers": {
    "paisa": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/paisa-mcp/dist/index.js"],
      "env": {
        "PAISA_API_URL": "https://your-paisa-api.workers.dev",
        "PAISA_API_TOKEN": "psa_your_token_here"
      }
    }
  }
}

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "paisa": {
      "command": "node",
      "args": ["/path/to/paisa-mcp/dist/index.js"],
      "env": {
        "PAISA_API_URL": "https://your-paisa-api.workers.dev",
        "PAISA_API_TOKEN": "psa_your_token_here"
      }
    }
  }
}

Edit your MCP config file (location varies by client):

{
  "mcpServers": {
    "paisa": {
      "command": "node",
      "args": ["/path/to/paisa-mcp/dist/index.js"],
      "env": {
        "PAISA_API_URL": "https://your-paisa-api.workers.dev",
        "PAISA_API_TOKEN": "psa_your_token_here"
      }
    }
  }
}

Environment variables

Variable	Required	Description
`PAISA_API_URL`	✅	Base URL of your Paisa API
`PAISA_API_TOKEN`	✅	API token from Settings → Integrations
`PAISA_PIN`	Optional	6-digit PIN for private/encrypted mode
`PAISA_USER_ID`	Required if PIN set	Your user ID (Settings → Profile)

Private mode

If you use PIN encryption, add your PIN and user ID:

"env": {
  "PAISA_API_URL": "...",
  "PAISA_API_TOKEN": "...",
  "PAISA_PIN": "123456",
  "PAISA_USER_ID": "your-user-id-from-profile"
}

Verify

Restart your AI client and look for the Paisa tools listed. Try asking:

“Show me my dashboard” or “How much did I spend last month?”