Skip to main content
Yoshi provides an MCP (Model Context Protocol) server that lets AI assistants read your financial data and take actions on your behalf through natural conversation.

​
What is MCP?

MCP is an open protocol that lets AI applications connect to external tools and data sources. When you connect Yoshi’s MCP server to an AI assistant, it can:
  • Fetch your account balances and transactions
  • Analyze spending patterns
  • Check financial health scores
  • View investment holdings
  • Track card rewards and expiring benefits
  • Execute paper trades (with approval)

​
Connect to Claude Desktop

Add Yoshi to your Claude Desktop configuration: 
{
  "mcpServers": {
    "yoshi": {
      "command": "yoshi",
      "args": ["mcp", "start"],
      "env": {
        "YOSHI_API_KEY": "yoshi_YOUR_KEY"
      }
    }
  }
}
Restart Claude Desktop after updating the config. Yoshi tools will appear in the tool picker.

​
Available tools

The MCP server exposes read and write tools:

​
Read tools

ToolDescription
get_accountsList linked financial accounts with balances
get_transactionsFetch recent transactions with optional filters
get_scoresView financial health scores
get_recurringList subscriptions, bills, and income streams
get_investmentsView investment holdings and performance
get_incomeIncome analysis and sources
get_card_benefitsActive card benefit periods with usage
get_expiring_benefitsBenefits expiring soon with value at risk

​
Write tools

ToolDescription
record_benefit_usageManually log a card benefit usage (e.g., lounge visit)
confirm_card_productCorrect a card product identification
create_paper_tradePlace a simulated stock trade
Write tools create pending actions that require your approval before executing. The assistant will share an approval link when needed.

​
Example conversations

Check spending:
“What did I spend on dining last month?”
The assistant uses get_transactions with date and category filters, then summarizes your dining expenses. Monitor rewards:
“Do I have any card benefits about to expire?”
The assistant calls get_expiring_benefits and surfaces unused credits with deadlines. Analyze finances:
“How are my financial scores trending? What should I focus on?”
The assistant fetches scores and provides personalized recommendations based on your Recovery, Capacity, and Baseline scores. Paper trading:
“Buy $1,000 of AAPL in my paper trading account.”
The assistant creates the trade action and provides an approval link. The trade executes after you approve.

​
Authentication

The MCP server uses your Yoshi API key for authentication. Set it as an environment variable or pass it in the MCP config: 
export YOSHI_API_KEY=yoshi_YOUR_KEY
Your API key grants access to your financial data. Only use it with trusted AI applications and never share it publicly.

​
What’s next

CLI

Use the CLI for scriptable access.

SDKs

Build programmatic integrations with TypeScript or Python.
Last modified on April 17, 2026