Finch MCP Server Instructions
Connect Finch to Your Favorite AI Assistant
Bring your financial picture directly into your preferred AI chat interface. By connecting Finch to assistants like Claude, ChatGPT, or Gemini, you can ask questions about your money in plain language, such as:
Connecting is completely passwordless and seamless. You don't need to copy API keys or deal with complex tokens — you simply pair your assistant using the Finch app and approve access using biometric security like Face ID or fingerprint authentication.
What Your Assistant Can Do
Finch runs a Model Context Protocol (MCP) server that grants your assistant a single data:read scope with 11 read-only tools, working purely from the data Finch already holds. Everything is read-only: the assistant can view your financial overview, but it cannot change anything, cannot move money, and never causes Finch to contact a bank. Figures are as fresh as the last refresh within the Finch app, and you can cut the connection from the app at any time.
Available Tools
| Tool | What It Does |
|---|---|
get_net_worth | View your net-worth trend over 1D, 1W, 1M, 6M, or YTD in your base currency. |
list_accounts | See accounts with type, currency, balance, and last update timestamp (account numbers masked to the last 4 digits). |
list_transactions | Fetch your recent transactions, newest first, with an optional date range (up to 100 per call). |
search_transactions | Search your transaction history in natural language (up to 25 matches). |
get_spending_summary | Compare income vs. expenses over 1W, 1M, 6M, 1Y, or YTD across all accounts. |
list_stock_holdings | View your stock and ETF positions. |
list_crypto_holdings | View your cryptocurrency positions. |
search_investment_transactions | Browse your buys and sells, filterable by symbol. |
list_goals | Check your savings goals and your progress. |
list_assets | View other assets you track manually (property, vehicles, valuables). |
get_market_snapshot | Read Finch's shared market briefing — mood, movers, and headlines (non-personal). |
Important
- Plan Limits: Data availability and refresh frequency between the Finch app and your MCP Server depend on your subscription tier (Free or Premium).
- Account Refreshes: Must be initiated directly inside the Finch app (by pulling to refresh). Your assistant always reads the latest data available in your app.
- Connecting & Removing Accounts: Bank accounts can only be added securely within the Finch app. Managing or removing accounts via MCP is not supported in the current version.
- Write Actions & Chat: The Finch MCP Server is strictly read-only. In-app Finch AI Chat and write operations are not available over MCP. Web searches are handled directly by your chosen AI assistant, not by Finch.
How Fresh Is the Data?
Your assistant reads the data Finch already holds and never contacts your bank.
Each account shows when it was last updated, and your assistant will tell you if a figure is more than a few days old.
To bring figures up to date, open the Finch app (or pull to refresh inside the app), then ask your assistant again.
Data from Swiss banks (for example UBS, ZKB, PostFinance, and others) is showcased as of its last refresh in the Finch app itself.
How to Connect Your Assistant
- 1
Add the Finch Server URL in Your Assistant
Add the official Finch server URL as a custom connector inside your assistant. Connecting requires no API keys, tokens, or web logins — your assistant will open the Finch pairing page in your browser showing an 8-character code.
https://api.fjnch.ch/mcp - 2
Open the Finch App (Requires Finch 0.4.8 or Later)
On your phone, tap “Open Finch on this device” or open the app manually and navigate to Menu › API keys › Connect an AI assistant.
- 3
Approve the Connection
Verify the assistant's registered domain name on the consent screen and confirm with Face ID or your fingerprint. The connection completes automatically within seconds.
- 4
Start Asking Questions
The pairing browser window automatically redirects or confirms the connection, and Finch appears under your connected assistants list in the app. There are no tokens or credentials to store.
Step-by-Step Instructions by Assistant
Claude (Web & Desktop)
- 1Navigate to Settings › Connectors › Add custom connector.
- 2Set the Name to Finch and the Remote MCP server URL to the official Finch server URL. Leave OAuth client fields empty — Finch handles client registration automatically.
- 3Click Add, then Connect to open the Finch pairing page.
- 4Complete the approval steps in your Finch app.
- 5In any chat session, verify Finch is enabled under the tools menu and start asking questions about your finances. (Cowork uses the same connector.)
ChatGPT
- 1Go to Settings › Connectors › Advanced and turn on Developer mode.
- 2Select Connectors › Create. Enter Finch as the name and set the MCP server URL to the official Finch server URL. Choose OAuth as the authentication type and click Save/Create.
- 3Open a new chat, select the Finch connector under developer-mode tools, and follow the browser prompts to pair your app.
Gemini CLI
- 1Open your terminal and add the Finch server:
- 2Run /mcp auth finch inside Gemini CLI to open the pairing window, then complete authorization in the Finch mobile app.
gemini mcp add --transport http finch https://api.fjnch.ch/mcpPrivacy & Security
Where Your Data Goes
Any financial information you request during a conversation is sent to your chosen assistant provider (such as Anthropic, OpenAI, or Google), which may process it outside Switzerland under its own terms.
Check the Domain, Not the Name
Any application can call itself “Claude” or “ChatGPT”. Always verify the assistant's registered domain on the consent screen inside the Finch app (e.g., claude.ai), and only approve requests you initiated yourself from that site.
Never Contacts Your Bank
An assistant cannot trigger a bank refresh or consume your plan's bank refresh allowances. It reads only what Finch already holds.
Disconnect Anytime
Disconnect at any time in the Finch app via Menu › API keys › Connected assistants. Disconnecting takes effect on the assistant's next request — simply deleting the connector inside the assistant app does not revoke access on Finch's side.
No Tokens to Manage
There is no key to store or keep secret. Connections stay active while you use them; connections unused for 7 days expire and require re-approval.
Protected Account Details
Account numbers are always masked to their final four digits. Full IBANs and sensitive identifiers never leave Finch servers.
Troubleshooting & FAQ
The code has expired.+
Pairing codes are valid for 10 minutes. Restart the connection setup from your assistant to generate a new code.
No pending connection matches this code.+
Double-check the entered characters. Codes never contain 0, O, 1, or I. Entering 10 incorrect codes temporarily pauses code entry for 10 minutes.
Unregistered redirect.+
The assistant sent Finch back to a different address than the one registered. Remove the connector inside your assistant and re-add it.
Assistant says Finch is not authorized.+
This occurs after manually disconnecting in the app or after 7 consecutive days of inactivity. Re-initiate the connection from your assistant to approve access again.
The pairing page never returns to the assistant.+
Return to your assistant and check whether Finch shows as connected. If not, remove the connector inside your assistant and re-add it.
The assistant answers with old balances.+
The assistant reads existing Finch data and never contacts the bank directly. Open the Finch app, pull to refresh your accounts, then ask the assistant again. If the app prompts you to reconnect your bank, complete that step first.
The “Open Finch on this device” button does nothing / I cannot find “Connect an AI assistant”.+
Your installed app version is older than 0.4.8. Update the Finch app via the App Store, then enter the pairing code manually under Menu › API keys › Connect an AI assistant.
Access & Support
Reach out to our support team if you have any issues with accessing your MCP Server or if you would like to request an extended MCP Server function for yourself or your team.
Get Support





