> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finup.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Connect AI assistants like Claude, Cursor, and ChatGPT to your Finup account.

Finup provides an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server — an open standard that lets AI assistants securely connect to external services. Once connected, your assistant can read your Finup account on your behalf: check balances, look up cards, analyze spending, and answer questions about your transactions in plain language.

```text theme={null}
https://api.finup.io/backend/mcp
```

You sign in with your regular Finup account through a browser window — no API keys or secrets to copy around. Access is read-only: the assistant can look at your data but cannot move money, issue cards, or change settings.

## What it can do

<CardGroup cols={2}>
  <Card title="Account & balances" icon="wallet">
    Wallet and card balance totals, account limits, capabilities, and fees.
  </Card>

  <Card title="Cards" icon="credit-card">
    List and filter cards by status, tag, or balance. Card numbers are always masked.
  </Card>

  <Card title="Transactions & analytics" icon="chart-line">
    Search, count, and summarize transactions; income, spending, runway, and top-merchant analytics.
  </Card>

  <Card title="Team & more" icon="users">
    Team members, notifications, card types available for issuing, and CSV/PDF/XLSX statement exports.
  </Card>
</CardGroup>

Ask things like:

* "How much did I spend on Facebook Ads this month?"
* "Which of my cards have a balance under \$10?"
* "Summarize my team's spending for the last 90 days and export it as a PDF."
* "Why was my last transaction declined?"

## Prerequisites

* A Finup account you can sign in to at [app.finup.io](https://app.finup.io)
* An AI app that supports remote MCP servers with OAuth: Claude (web or desktop), Claude Code, Cursor, ChatGPT, and others

## Connect to Claude

Works the same on [claude.ai](https://claude.ai) and the Claude desktop app.

<Steps>
  <Step title="Open connector settings">
    Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (or **Settings → Connectors** in the desktop app) and click **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/finup-8fa91179/OVaPFoGFyxLCms_9/images/mcp/claude-connectors.png?fit=max&auto=format&n=OVaPFoGFyxLCms_9&q=85&s=1d4213c46e9dc4b55c4a7076667c3fef" alt="Claude connector settings" width="2430" height="1525" data-path="images/mcp/claude-connectors.png" />
    </Frame>
  </Step>

  <Step title="Add the Finup server">
    Enter a name (e.g. `Finup`) and the server URL:

    ```text theme={null}
    https://api.finup.io/backend/mcp
    ```

    <Frame>
      <img src="https://mintcdn.com/finup-8fa91179/OVaPFoGFyxLCms_9/images/mcp/claude-add-connector.png?fit=max&auto=format&n=OVaPFoGFyxLCms_9&q=85&s=e17efcdfd03a0c01a603f110d14ec48c" alt="Add custom connector dialog" width="2430" height="1525" data-path="images/mcp/claude-add-connector.png" />
    </Frame>
  </Step>

  <Step title="Sign in">
    Click **Connect** next to the new connector. A browser window opens — sign in with your Finup account and approve access.

    <Frame>
      <img src="https://mintcdn.com/finup-8fa91179/OVaPFoGFyxLCms_9/images/mcp/finup-consent.png?fit=max&auto=format&n=OVaPFoGFyxLCms_9&q=85&s=3d5f54f35d3e81fc5ed44ef6333db428" alt="Finup sign-in and consent screen" width="2296" height="1440" data-path="images/mcp/finup-consent.png" />
    </Frame>
  </Step>

  <Step title="Verify">
    In any chat, open the tools menu and make sure the Finup connector is enabled, then ask something like "What's my wallet balance?"

    <Frame>
      <img src="https://mintcdn.com/finup-8fa91179/OVaPFoGFyxLCms_9/images/mcp/claude-tools-menu.png?fit=max&auto=format&n=OVaPFoGFyxLCms_9&q=85&s=5a5635f80c788e496825a40d4acb005c" alt="Finup connector enabled in a chat" width="2340" height="1469" data-path="images/mcp/claude-tools-menu.png" />
    </Frame>
  </Step>
</Steps>

## Connect to Claude Code

<Steps>
  <Step title="Add the server">
    ```bash theme={null}
    claude mcp add --transport http finup https://api.finup.io/backend/mcp
    ```
  </Step>

  <Step title="Authenticate">
    Inside a Claude Code session, run `/mcp`, select **finup**, and complete the sign-in in the browser window that opens.
  </Step>

  <Step title="Verify">
    Run `/mcp` again — **finup** should show as connected with its tools listed.
  </Step>
</Steps>

## Connect to Cursor

<Steps>
  <Step title="Add the server config">
    Open **Cursor Settings → Tools & MCP → Add new MCP server**, or add this to `~/.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "finup": {
          "url": "https://api.finup.io/backend/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Sign in">
    Cursor shows a **Needs login** state next to the new server — click it and complete the Finup sign-in in your browser.
  </Step>

  <Step title="Verify">
    The server status turns green in **Settings → Tools & MCP**, and the Finup tools appear in the agent's tool list.
  </Step>
</Steps>

## Other MCP clients

Any client that supports remote MCP servers over **Streamable HTTP** with OAuth (VS Code Copilot, Windsurf, and others) works the same way: point it at `https://api.finup.io/backend/mcp` and complete the browser sign-in when prompted.

## Troubleshooting

* **Sign-in window never opens or errors out** — remove the connector, restart the app, and add it again from scratch. Some apps cache a failed registration.
* **Tools don't appear after connecting** — make sure the connector is enabled for the current chat (Claude: tools menu; ChatGPT: **+** menu; Cursor: MCP server toggled on).
* **Requests return authorization errors after some time** — your session expired. Reconnect the server to sign in again.

## Security

* Access is scoped to your Finup user and role — the assistant sees exactly what you can see in the app, nothing more.
* All tools are read-only. The only thing the server can create is a downloadable statement export you explicitly ask for.
* Full card numbers and CVCs are never exposed; PANs are always masked.
* You can revoke access at any time by removing the connector from your AI app.

<Warning>
  Your assistant reads real account data. Only connect Finup in AI apps and workspaces you trust, and be mindful when sharing chats that include balances or transactions.
</Warning>