Docs — MCP server

Connect your money to any AI assistant.

Plutonus is a hosted MCP server that connects your bank accounts, cards, and brokerages to Claude, ChatGPT, and any assistant that speaks the Model Context Protocol. Connect once, then ask about your money in plain language — read-only, on your terms.

Server endpoint
https://mcp.plutonus.app/mcp

Streamable HTTP · OAuth 2.1 · read-only. New here? See the setup steps.

What it can do

One SQL tool. Every question.

The heart of Plutonus is plutonus.data__execute_sql: read-only SQL over your own financial data. Instead of a dozen canned endpoints, your assistant writes exactly the query your question needs. Every tool is read-only, and amounts come back as integer cents.

Data · the headline tool
plutonus.data__execute_sql

Run a read-only SELECT (or WITH) query across your transactions, accounts, and merchants. Filter, aggregate, join, window — anything you can express in SQL, your assistant can ask. Writes are rejected; queries run in a sandbox with tight timeouts and row caps.

  • SELECT / WITH only — no writes, ever
  • Runs against your own isolated database
  • Every query is logged to your audit trail
Example queryread-only
SELECT personal_finance_category_primary AS category,
       SUM(-incoming_amount_cents) / 100 AS spent
FROM bank_transactions
WHERE incoming_amount_cents < 0
  AND transacted_date >= current_date - INTERVAL 30 DAY
GROUP BY 1
ORDER BY spent DESC;
← 5 rows · spending by category, last 30 days
And the helpers around it
plutonus.data__get_schema

List every table and column available to query, so your assistant knows the exact shape before it writes SQL.

plutonus.data__null_rates

Check per-column completeness for a table — how much of your data is actually populated before you trust an answer.

plutonus.accounts__list_financial_accounts

Your linked bank, credit, and investment accounts with balances — a typed shortcut for the common case.

plutonus.accounts__check_account_balance

Balance, available balance, and credit utilization for one account.

The tools available in a session depend on the accounts you've connected and the scopes you approve when you sign in.

Trust & safety

Read-only, and revocable.

Here's exactly what a connected assistant can and can't do — and how you stay in charge.

What it can see
  • Your linked account list and balances
  • Transaction history — merchant, amount, date, category, account
  • Spending breakdowns and cash-flow analysis
  • The schema of your financial dataset, for read-only queries
What it can't do
  • Move money, transfer funds, or pay bills
  • Place trades or change account settings
  • See your bank login — Plaid handles linking
  • Write to or modify your financial data

You approve the connection

Connect over OAuth 2.1 and approve read-only access. The assistant gets a limited, revocable token — never your login credentials.

Revoke anytime

Disconnect any assistant in one click from Plutonus. Access stops immediately.

Every call is audited

Each tool call is logged with its arguments redacted and retained for 90 days. The data returned to your assistant is never stored by Plutonus.

Starter prompts

Ask it anything about your money.

Once connected, talk to your assistant in plain language — it turns each question into a read-only SQL query. Or hand it the SQL yourself. A few starting points:

What did I spend on groceries last month?

How does my spending this month compare to my usual pace?

List my accounts and their current balances.

Write the SQL to rank my top 10 merchants by total spend this year.

Show my income vs. spending, month over month, for the last 6 months.

FAQ

Questions, answered.

Still curious? Email us at hello@plutonus.app. A real human writes back within a day.

Which AI assistants does this work with?

Any client that speaks MCP — Claude (Desktop, Web, Code), ChatGPT, Cursor, and a growing list of others. You connect Plutonus once and it works across all of them; your accounts and context live in Plutonus, not the model.

Can my assistant move money?

No. Plutonus is read-only — it can read balances and transactions and run analysis, but it can never transfer funds, pay bills, or place trades. Anything that moves money still happens in your bank's or brokerage's own app.

Do I need to install or configure anything?

No. Plutonus is a hosted server — there's no CLI and no config files. Paste the server URL into your assistant's connector settings and approve the connection.

How do I connect my bank accounts?

The first time your assistant calls a Plutonus tool, you'll securely link your accounts through Plaid. Plutonus never sees your bank login — Plaid handles it.

How is access secured, and can I revoke it?

You connect over OAuth 2.1 and approve read-only access; the assistant receives a limited, revocable token, never your credentials. Revoke any assistant anytime from Plutonus. Every tool call is audited, and the data returned to your assistant is never stored.

What data can my assistant access?

Your account list and balances, your transaction history, spending and cash-flow analysis, and the schema of your financial dataset — nothing else.

Why don't I see a certain capability?

The tools available in a session depend on the accounts you've connected and the scopes you approved when you signed in. Connect more accounts or re-approve to surface more.