How to Use the EOD Historical Data MCP in Windsurf

Q: How does Windsurf use the EOD Historical Data MCP Server to build backtests?

Cascade plans a sequence using geteodhistorical and getsplits to fetch raw numbers. It then writes the backtesting logic and runs it locally in your workspace without needing step-by-step prompts.

Q: Can Cascade pull stock fundamentals automatically?

Yes. Cascade uses getfundamentals to inspect balance sheets and cash flows. It parses the raw JSON and integrates it directly into your local scripts or databases.

Q: How do I configure the EOD Historical Data API key in Windsurf?

Put your Vinkius token in /.codeium/windsurf/mcpconfig.json under the MCP server configuration key. Windsurf passes the authenticated requests to the EOD endpoints securely.

Q: Can I screen stocks using this setup?

Yes. The agent runs getscreener with your specific parameters, like P/E ratios or volume. It then uses the output to fetch deep historical data for the matching tickers.

Run Cascade to build complete financial models and backtesters by letting Windsurf fetch market data directly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EOD Historical Data MCP to Windsurf

Create your Vinkius account to connect EOD Historical Data to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup EOD Historical Data with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build automated trading backtesters in Windsurf

Tell Cascade to write a backtesting script, and it will autonomously pull historical prices using `get_eod_historical` without waiting for your input. It maps symbols with `get_id_mapping`, grabs dividends via `get_dividends`, and adjusts the math on its own. Instead of prompting for every single step, you give Cascade a high-level trading thesis. The agent chains the data fetching with code generation, running local tests against the retrieved data to prove the strategy works before showing you the final code.

Auto-generate fundamental analysis dashboards

Let Windsurf plan a multi-step sequence to parse complex corporate health metrics. Cascade calls `get_fundamentals` to pull financial statements, then grabs historical pricing via `get_intraday_historical` to calculate valuation ratios in real time. The agent writes the UI code, injects the fetched data, and refines the styling autonomously. It handles the entire pipeline from raw API data to a fully rendered dashboard in your workspace.

Track macro trends with this MCP Server

This MCP Server lets Cascade monitor broader market movements by combining yield curves and commodity pricing. The agent runs `get_ust_yield_rates` alongside `get_commodities` to build macro indicators directly in your codebase. You don't need to manually feed rates into your scripts. Cascade discovers these tools, queries the EOD Historical Data endpoints, and formats the output into clean JSON files for your local models.

Setup guide

Set up EOD Historical Data MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the EOD Historical Data MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my EOD Historical Data payment history." If connected, Cascade will call the EOD Historical Data tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "eod-historical-data-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by EOD Historical Data. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect EOD Historical Data now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about EOD Historical Data MCP in Windsurf

Cascade plans a sequence using `get_eod_historical` and `get_splits` to fetch raw numbers. It then writes the backtesting logic and runs it locally in your workspace without needing step-by-step prompts.

Yes. Cascade uses `get_fundamentals` to inspect balance sheets and cash flows. It parses the raw JSON and integrates it directly into your local scripts or databases.

Put your Vinkius token in `~/.codeium/windsurf/mcp_config.json` under the MCP server configuration key. Windsurf passes the authenticated requests to the EOD endpoints securely.

Yes. The agent runs `get_screener` with your specific parameters, like P/E ratios or volume. It then uses the output to fetch deep historical data for the matching tickers.

Vinkius runs the MCP server in an ephemeral V8 Isolate Sandbox. Your API keys, query parameters, and ticker searches are processed securely and never persisted or shared.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript