offramp-mcp

Offramp MCP Server

Give Claude access to retirement-focused city financial data for 500+ cities worldwide.

Features

• Cost of Living: Monthly expenses, cost index (NYC=100)
• Tax Rates: Effective rates for retirement income, special programs
• Healthcare Costs: Quality index, cost multiplier vs US
• Visa Requirements: Accessibility, income requirements, citizenship path
• Offramp Index: 0-100 retirement-friendliness score
• Safety, Climate, Expat Community: Additional factors

Quick Start

1. Get an API Key

curl -X POST https://zsriidofobkmztqabfst.supabase.co/functions/v1/agent-api/auth/register \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InpzcmlpZG9mb2JrbXp0cWFiZnN0Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjAwMjAzOTQsImV4cCI6MjA3NTU5NjM5NH0.BTR8LN053UH4-qBNHSgZ6uomXT3LEOUyfGra4QfTMwI" \
  -H "Content-Type: application/json" \
  -d '{"email": "[e-mail]"}'

Save the api_key from the response - it cannot be retrieved later!

2. Install Dependencies

cd mcp-server
npm install
npm run build

3. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "offramp": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "OFFRAMP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

4. Restart Claude Desktop

The Offramp tools will now be available to Claude.

Available Tools

Tool	Description	Cost
get_city_profile	Full city data (cost, tax, healthcare, visa, etc.)	$0.008
get_city_cost_of_living	Cost of living only	$0.002
get_city_tax_rate	Tax rate for retirees	$0.002
get_city_healthcare	Healthcare costs	$0.002
get_ranked_cities	Top cities by Offramp Index	$0.005
list_cities	All available cities	$0.005
check_balance	Check API key balance	Free

Example Conversations

User: "Where should I retire on $2,000/month?"

Claude will use get_ranked_cities and get_city_cost_of_living to find affordable cities.

User: "Compare Lisbon and Porto for retirement taxes"

Claude will use get_city_tax_rate for both cities.

User: "What's the healthcare situation in Chiang Mai?"

Claude will use get_city_healthcare to get details.

Pricing

• New API keys start with $0.80 balance (100 free calls)
• Top up via Stripe: minimum $5
• Per-call pricing: $0.002 - $0.008

The Offramp Index

Our proprietary 0-100 score measuring retirement-friendliness:

• Cost of Living (35%): Lower cost = higher score
• Safety (15%): Lower crime = higher score
• Healthcare Quality (15%): Better healthcare = higher score
• Climate (12%): More sunshine = higher score
• Visa Accessibility (10%): Easier visas = higher score
• Expat Community (8%): Larger community = higher score
• Air Quality (5%): Less pollution = higher score

Support

• Website: https://offramp.live
• API Docs: https://offramp.live/openapi.yaml