How to Use the EODHD Financial MCP in Mastra AI

Q: How do I register the EODHD Financial tools inside a Mastra AI agent using MCP?

Instantiate the MCPClient with your Vinkius server URL and call listTools. You then spread those tools directly into your Mastra agent definition.

Q: How do I require human approval before Mastra AI executes an EODHD Financial tool?

You configure the requireToolApproval setting on your agent. This pauses execution when the agent tries to run tools like getdividends until a human approves the action.

Q: Can I fetch historical end-of-day data for a specific date range?

Yes, you use geteoddata and pass the datefrom and dateto parameters. This limits the returned dataset to your exact backtesting window.

Build automated trading workflows and multi-step financial agents using Mastra AI and this financial data server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EODHD Financial MCP to Mastra AI

Create your Vinkius account to connect EODHD Financial to Mastra AI 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 EODHD Financial with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated dividend tracking workflows

`get_dividends` retrieves ex-dividend dates, payment schedules, and amounts to feed your automated Mastra AI workflows. The engine monitors these dates and triggers conditional downstream actions, like notifying portfolio managers. You can chain this with automatic retries to ensure you never miss an update due to transient network failures. Manual intervention is eliminated because the built-in workflow engine handles the execution logic.

Multi-step corporate action processing

`get_historical_splits` fetches split histories for multiple tickers to automatically adjust your database records. This MCP lets Mastra AI coordinate this search across exchanges and updates your internal portfolio values. If a split query fails, the framework automatically retries with exponential backoff. Your historical price databases remain accurate even during API hiccups.

Automated exchange discovery with this MCP Server

`get_exchange_symbols` lists every active ticker on a given exchange to update your automated scanning systems. Your Mastra AI agent uses this list to discover new assets and initiate deeper fundamental analysis. The workflow handles the entire discovery pipeline, passing the discovered symbols to other tools in the chain. This setup removes manual spreadsheet work from your daily market research.

Setup guide

Set up EODHD Financial MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All EODHD Financial tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "eodhd-financial-mcp-client",
  servers: {
    "eodhd-financial-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "EODHD Financial Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to EODHD Financial tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent EODHD Financial transactions"
);
console.log(result.text);

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 EODHD Financial 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 EODHD Financial 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 EODHD Financial MCP in Mastra AI

Instantiate the `MCPClient` with your Vinkius server URL and call `listTools`. You then spread those tools directly into your Mastra agent definition.

Yes, Mastra AI has built-in retry logic with exponential backoff. If a call like `get_fundamentals` fails due to a network glitch, the framework retries the operation automatically.

You configure the `requireToolApproval` setting on your agent. This pauses execution when the agent tries to run tools like `get_dividends` until a human approves the action.

Yes, you use `get_eod_data` and pass the `date_from` and `date_to` parameters. This limits the returned dataset to your exact backtesting window.

Vinkius manages your API credentials securely, injecting them into the ephemeral sandbox environment at runtime. Your keys and financial queries never touch the Mastra client logs or external servers.

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