Documentation

Give your AI assistant real-time access to financial data, analysis tools, and economic indicators.

What You Can Do

Ask your AI assistant questions like these, and Savvy will provide real-time data and analysis:

🏠

Real Estate Analysis

"I have a rental property worth $700K with $410K mortgage at 3%. Rent is $4,000/mo. Should I hold or sell?"

📈

Market Data

"Compare AAPL, GOOGL, and MSFT performance over the last year. Show me their financials."

🏛️

Economic Reports

"Create a report on US national debt trends, interest payments, and how they relate to inflation."

🏡

Rent vs Buy

"I'm deciding between renting at $3,500/mo or buying a $900K home. What's the breakeven point?"

Connect Your AI Assistant

Connect Savvy to your preferred AI assistant via the Model Context Protocol (MCP) or REST API.

🤖

Claude Desktop (MCP)

Recommended

Native integration via Model Context Protocol. Tools appear directly in Claude.

With API Key:

Add to ~/Library/Application Support/Claude/claude_desktop_config.json: 

{
  "mcpServers": {
    "savvy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.savvy-mcp.com/sse"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

With OAuth (Browser Sign-In):

{
  "mcpServers": {
    "savvy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.savvy-mcp.com/sse"]
    }
  }
}

Without an API key, you'll be prompted to sign in via browser on first use.

💬

ChatGPT (Custom GPT)

Create a Custom GPT with Savvy as an action.

  1. Go to ChatGPT GPT Editor
  2. Click "Create a GPT" → "Configure" → "Create new action"
  3. Import from URL: https://api.savvy-mcp.com/openapi.json
  4. Set Authentication: API Key, Header name: X-API-Key
  5. Enter your API key and save
✨

Google Gemini

Use Savvy tools via Gemini's function calling in your code. 

import requests

def call_savvy(tool_name, params):
    return requests.post(
        f"https://api.savvy-mcp.com/api/tools/{tool_name}",
        headers={"X-API-Key": "YOUR_API_KEY"},
        json=params
    ).json()
🔧

Custom / Other LLMs

Use the REST API or MCP SSE endpoint with any LLM or application.

  • GET /api/tools - List all tools
  • POST /api/tools/{name} - Execute a tool
  • GET /openapi.json - OpenAPI spec (for tool definitions)
  • GET /sse - MCP Server-Sent Events endpoint

Base URL: https://api.savvy-mcp.com

Skill Guides

Detailed guides for each module. These help you (and your AI) get the most out of Savvy's tools.

🏠

Real Estate Hold/Sell Analysis

ROE, IRR, sensitivity analysis, multi-property comparison

▼
📈

Market Data

Stock quotes, financials, crypto, comparisons via Yahoo Finance

▼
🏛️

Macro-Economic Analysis

FRED data, economic indicators, custom reports

▼
🏡

Rent vs Buy Analysis

Breakeven analysis, cost comparison over time

▼
📊

Visualization

Interactive Plotly charts

▼
🎨

Customization Pro

Custom report styles, branding, multi-format export

▼

All Tools

Loading tools...

Authentication

API Key

For server-to-server or MCP integrations. 

X-API-Key: sk_live_xxx

OAuth (Bearer Token)

For user-facing apps with Google Sign-In. 

Authorization: Bearer <token>

Plans

Free

Get started

  • All public tools (50+)
  • Market data, macro indicators
  • Real estate analysis
  • 100 calls/day
Popular

Pro

For power users

  • Everything in Free
  • Custom report styles & branding
  • Multi-format export (PDF, slides, Word)
  • Custom narrative tone & voice
  • Session preferences & history
  • 10,000 calls/day

Enterprise

Custom solutions

  • Everything in Pro
  • Custom data sources
  • Private models & skills
  • SSO & team management
  • Unlimited calls

Manage your plan

SDKs

Python

pip install savvy-sdk
Coming Soon

Node.js

npm install savvy-sdk
Coming Soon

REST API

Available Now