sign in
sign in
// windsurf integration

Market data tools
inside Windsurf.

Connect TickerDB to Windsurf via MCP. Cascade gets market summaries, watchlists, and ticker event history — useful when building trading bots, analysis tools, or financial applications.

try for free read the docs
// setup

Add to Windsurf in one step.

Windsurf supports MCP tool servers natively. Add the TickerDB config to your Windsurf MCP settings and the tools become available to Cascade immediately.

~/.codeium/windsurf/mcp_config.json 
{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key"
      }
    }
  }
}

The MCP server discovers all available tools at connection time. No manual tool definitions needed.

// in practice

Market context while you code.

Ask Cascade about current market conditions while building financial applications. It chains tools automatically — get a summary, use summary event mode for historical context, monitor your watchlist.

1
get_summary(ticker="INTC")
Full categorical snapshot for the ticker
2
get_summary(ticker="INTC", field="rsi_zone", band="deep_oversold")
Historical ticker events with aftermath
3
get_summary(ticker="AMD")
Compare by pulling a second summary
// state changes

Track state changes effortlessly.

Most market data APIs return point-in-time snapshots. TickerDB tracks state transitions — your agent sees what changed, not just what is.

json 
{
  "ticker": "AAPL",
  "changes": [
    {
      "field": "rsi_zone",
      "from": "neutral",
      "to": "oversold"
    },
    {
      "field": "trend",
      "from": "uptrend",
      "to": "downtrend"
    }
  ]
}
// what your agent sees

What your agent sees.

Every tool returns categorical facts — not raw OHLCV data. Your agent can branch on "oversold" without needing to know what RSI > 70 means.

json 
{
  "ticker": "NVDA",
  "trend": "strong_uptrend",
  "momentum": {
    "rsi_zone": "overbought",
    "macd_signal": "bullish"
  },
  "volatility": "high",
  "fundamentals": {
    "pe_zone": "above_historical_avg",
    "earnings_surprise": "positive"
  }
}
// available tools

What your agent can call.

Every tool returns categorical, pre-computed data. Your agent gets facts it can reason about immediately.

get_summary

Full categorical snapshot for a single asset — trend, momentum, volatility, volume, extremes, fundamentals, support/resistance.

get_watchlist

Live summary data for all tickers in your saved watchlist.

get_watchlist_changes

Field-level diffs for your watchlist since the last pipeline run.

add_to_watchlist

Add tickers to your persistent watchlist.

remove_from_watchlist

Remove tickers from your watchlist.

get_search

Multi-field filtering across all assets. Build complex queries with arbitrary filter combinations.

get_schema

All queryable fields with types, values, and descriptions. Always free.

get_account

Your plan tier, rate limits, and current API usage.

create_webhook

Register a webhook URL for watchlist change notifications.

list_webhooks

List your registered webhook URLs.

delete_webhook

Remove a registered webhook.

full tool reference →
// why tickerdb + windsurf

Built for how agents consume data.

Build with real data

When you're writing a trading bot or analysis tool, Cascade can pull actual market conditions to validate logic, generate test cases, or check if your strategy handles edge cases correctly.

Compact responses

Tool-call context windows are limited. TickerDB responses are a fraction of the tokens you'd need to pass raw OHLCV data.

Pre-computed daily

No infrastructure to maintain. No cron jobs, no indicator math, no data pipelines. TickerDB handles computation and syncing.

Start building.

Try for free. No credit card required.

try for free read the docs