This repository holds documentation, client configuration and agent skills only. The server is hosted by Truthifi at https://api.truthifi.com/mcp; there is nothing to build or run.
Quick start
Claude (web or desktop; then available on mobile): Customize → Connectors → + → Add custom connector → paste https://api.truthifi.com/mcp and leave Advanced settings empty. On Team or Enterprise, an Owner adds it first under Organization settings → Connectors.
ChatGPT (web): ChatGPT connects custom MCP servers through developer mode, which OpenAI describes as intended for developers; read OpenAI's guidance before turning it on. Then create an app, paste https://api.truthifi.com/mcp and choose OAuth. Which ChatGPT plans can use it, and whether tools that change data are allowed, is set by OpenAI; current steps: https://truthifi.com/connect.
Claude Code
claude mcp add --transport http truthifi https://api.truthifi.com/mcp
# or install the plugin (connector plus skills):
/plugin marketplace add truthifi/truthifi-mcp
/plugin install truthifi@truthifi
Gemini CLI
gemini extensions install https://github.com/truthifi/truthifi-mcp
OpenAI Codex
codex mcp add truthifi --url https://api.truthifi.com/mcp
# if the browser sign-in was skipped or expired: codex mcp login truthifi
Agent skills (skills-aware agents)
npx skills add truthifi/truthifi-mcp
Configs for Cursor, VS Code, GitHub Copilot CLI, Windsurf/Devin, Antigravity, Kiro, Zed, JetBrains, Cline, Goose, Continue, OpenCode, LM Studio and more are in configs/, with which ones we've tested.
Cursor plugin (connector plus skills): install Truthifi from the Cursor Marketplace, or use the button above for the MCP server only. Kiro power: Powers → Import power from GitHub → https://github.com/truthifi/truthifi-mcp. Step-by-step guides: https://truthifi.com/connect.
What you can ask
- What am I paying in fees across all my accounts, and which account costs the most?
- How is my portfolio split by asset class, and where am I most concentrated?
- How has my portfolio performed this year compared with its benchmark?
- Which individual stocks am I most exposed to, counting what I hold through funds?
- What are the findings behind my Truthifi Score?
- Run a full fee audit of my household.
- Build my household balance sheet.
- Give me a tax preview for this year.
Tools
34 tools. Truthifi's access to your bank and brokerage accounts is read-only: nothing your AI assistant does through Truthifi can move money, place trades or change settings there. Three tools change data inside Truthifi only, marked below.
Some tools need a higher plan, and some have per-plan limits; get_subscription_info (free) tells your assistant what yours includes. Full reference: docs/tools.md · machine-readable: docs/tools.json · live page: https://truthifi.com/mcp-tools.
Skills included
About Truthifi
Truthifi is unlocking agentic finance for everyone. We believe a household should own the record of its financial life: everything comes in, and nothing goes out unless the household says so.
- The Vault. What people own finally counts: investments, bank and credit accounts, insurance policies, property, private holdings and the documents behind them, in one verified record.
- The Decoder. 18,000 dialects of finance, translated into one. Every holding identified, sells and splits handled correctly, and the record kept whole when a connection breaks.
- The Score. A complete picture, turned into a next action. Truthifi reviews the whole record every night and shows where to focus.
- The Feed. News that actually knows what you own.
- The Dashboard. Insight no single statement can give you: every fee in Fee X-Ray, look-through to your true exposure, benchmarked performance, cash flow and the Wealth Map.
- Sharing. Families decide what their team sees, and can revoke access at any time.
- Families, agents and advisors. Finally working from one verified truth.
Truthifi doesn't sell investments, so it can stay independent. Learn more at truthifi.com.
Plans, credits, access and your data
Plans and credits. Each tool call uses the credits shown in the Tools table above; tools marked 0 are free. Each Truthifi plan that includes MCP access has a daily and a monthly allowance of AI tool credits, and a free plan is enough to try the server. Your assistant can call get_subscription_info (free) to see your plan, credits used and which tools you can use, and get_subscription_catalog (free) to compare plans. Prices and allowances: https://truthifi.com/pricing.
What your assistant receives. Tool results contain your financial data, such as accounts, balances, holdings, transactions, fees and advisor details. They are sent to the AI assistant you connected and are then handled under that provider's terms and privacy policy, not Truthifi's.
Approving access. When you connect an assistant, Truthifi asks you to sign in and then shows a consent screen naming the application and listing what it can read and the two things it can change, with Authorize and Cancel buttons. Nothing is shared until you choose Authorize.
The three tools that change data. They change data inside Truthifi only. None of them can move money, place trades or change anything at your bank or brokerage.
create_asset_liabilityadds one asset or liability you track by hand. It shows a preview first and saves only after you confirm.delete_asset_liabilitypermanently deletes one asset or liability you track by hand. It applies only to items you added by hand, never to linked accounts.run_scanrefreshes one connection's data now instead of waiting for the automatic refresh. It uses 3 credits, re-reads data and never changes anything at the institution.
Most assistants also ask for your approval before they call a tool, depending on their settings.
Revoking access. In the Truthifi app, open Settings to see the AI assistants you've connected, choose which accounts each one can see, and revoke an assistant's access. Revoking stops that assistant's access from Truthifi's side. You can also remove the connector in the assistant itself. To request access to or deletion of your data, email [email protected].
Security and privacy
- Your assistant can't move money, place trades or change anything at your bank or brokerage. Three tools change data inside Truthifi only.
- Data the tools return goes to the AI assistant you chose and is handled under that provider's terms.
- OAuth sign-in; credentials never pass through the chat.
- Details: docs/security-and-privacy.md · Privacy · Terms · Security · report a vulnerability: SECURITY.md
Important information
Truthifi is not a registered investment adviser or broker-dealer. Truthifi provides data and analysis, not investment, tax or legal advice, and nothing here is a recommendation to buy or sell any security. The Truthifi Score and findings reflect Truthifi's own methodology. Past performance does not guarantee future results; benchmark comparisons are for context. Account data comes from your institutions through aggregation partners and may be delayed or incomplete; check important figures against your statements. Answers are written by the AI assistant you use, not by Truthifi, and may contain mistakes. Use of Truthifi is governed by the Truthifi terms.
Support
Help center · [email protected] · FAQ
License and trademarks
Text, configuration and skill files are MIT licensed (see LICENSE and NOTICE). The Truthifi name, logo and Truthifi Score are trademarks of Truthifi, Inc. and are not licensed under MIT; see TRADEMARKS.md. Claude, ChatGPT, Gemini, Copilot, Cursor and other product names are trademarks of their owners and are used only to describe compatibility.