sign in
sign in
// windsurf integration

Market data tools
inside Windsurf.

Connect TickerAPI to Windsurf via MCP. Cascade gets market summaries, technical scans, and comparisons — 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 TickerAPI config to your Windsurf MCP settings and the tools become available to Cascade immediately.

~/.codeium/windsurf/mcp_config.json 
{
  "mcpServers": {
    "tickerapi": {
      "command": "npx",
      "args": ["tickerapi-mcp-server"],
      "env": {
        "TICKERAPI_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 — scan for opportunities, drill into specifics, compare alternatives.

1
scan_oversold(sector="Technology")
Returns oversold stocks in the tech sector
2
get_summary(ticker="INTC")
Full categorical breakdown for top result
3
compare_assets(tickers=["INTC", "AMD"])
Side-by-side comparison for validation
// state changes

Track state changes effortlessly.

Most market data APIs return point-in-time snapshots. TickerAPI 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 factual snapshot for a single asset — trend, momentum, fundamentals, support/resistance.

compare_assets

Side-by-side technical and fundamental comparison of two or more tickers.

list_assets

Browse all supported tickers with filtering and search.

list_sectors

List all valid sector values with asset counts for scan filtering.

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.

scan_oversold

Assets in confirmed oversold conditions across multiple indicators.

scan_overbought

Assets in overbought RSI conditions with severity rankings.

scan_breakouts

Momentum breakouts with volume confirmation.

scan_unusual_volume

Volume anomalies and accumulation patterns.

scan_valuation

Historically undervalued or overvalued assets based on fundamental metrics.

scan_insider_activity

Notable insider buying and selling activity.

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 tickerapi + 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. TickerAPI 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. TickerAPI handles computation and syncing.

Start building.

Try for free. No credit card required.

try for free read the docs