Koko Finance Developer Docs

Credit card intelligence via REST API or MCP server. Analyze portfolios, compare cards, get recommendations, check renewal value, get merchant-level advice, extract card terms (APR/penalties), and track data changes over time.

REST API https://kokofinance.net/api/v1

MCP https://kokofinance.net/mcp/

Getting Started

Try the API in 60 seconds.

Get API Key — Free

Get an API Key

Make Your First Call

curl -X POST https://kokofinance.net/api/v1/cards/compare \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card_names": [
      "Chase Sapphire Preferred",
      "Capital One Venture X"
    ],
    "params": {
      "spending": {"dining": 400, "travel": 500},
      "primary_goal": "travel"
    }
  }'

Or Use the Python SDK

pip install koko-finance

from koko_finance import KokoClient

client = KokoClient(api_key="YOUR_API_KEY")
result = client.compare_cards(
    cards=[
        {"card_name": "Chase Sapphire Preferred", "annual_fee": 95},
        {"card_name": "Capital One Venture X", "annual_fee": 395},
    ],
    spending={"dining": 400, "travel": 500},
    primary_goal="travel",
)
print(result)

Explore the Docs

REST API Reference

22 endpoints for portfolio analysis, card comparison, recommendations, merchant intelligence, card terms, data history, and points programs.

POST & GET endpoints • JSON responses • <100ms fast mode

MCP Server

14 tools and 5 workflow prompts for AI assistant integration. Connect Claude, Cursor, or any MCP-compatible client.

OAuth + API key auth • Streamable HTTP • Same quota as REST

Python SDK & Reference

Lightweight Python client with typed exceptions. Plus rate limit tiers, error codes, and response format reference.

pip install koko-finance • Python 3.8+ • MIT license