How to Use the FRED Series — U.S. Economic Time Series MCP in Mastra AI
Build resilient workflows that track official U.S. economic indicators using Mastra AI.
Works with every AI agent you already use
…and any MCP-compatible client
Connect FRED Series — U.S. Economic Time Series MCP to Mastra AI
Create your Vinkius account to connect FRED Series — U.S. Economic Time Series 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.
Automate Macro Data Retrieval
The `get_observations` tool pulls historical and current data values for specific economic series. It handles frequency aggregation and unit transformations automatically. You just pass an ID like FEDFUNDS or DGS10. Mastra AI takes that data and passes it down your workflow chain. If the API hits a rate limit, the framework's exponential backoff kicks in and retries the pull without breaking your pipeline.
Monitor Indicator Updates
Your agent uses `get_series_updates` to check for newly released macro or regional data. This is how you build triggers that react to fresh economic reports. When the data drops, the workflow executes. If you need to verify historical context, `get_series` grabs the metadata to confirm you are looking at the right metric before the next conditional branch fires.
Mastra AI MCP Server Revision Tracking
The `get_vintage_dates` tool pulls the exact dates when historical data was revised. Official numbers get adjusted constantly, and this lets your workflows account for those shifts. If your agent hits an unknown metric, it calls `search_series` to find the correct ID. Mastra AI handles the entire conditional logic, searching the 816,000+ database and routing the correct series ID to the next step.
Set up FRED Series — U.S. Economic Time Series MCP in Mastra AI
Prerequisites
- Node.js 18+ and a TypeScript project
-
@mastra/mcp+@mastra/corepackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install @mastra/mcp @mastra/coreplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Configure the MCPClient
Create an
MCPClientwith your Vinkius endpoint as aURLobject. 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'stoolsobject. All FRED Series — U.S. Economic Time Series tools become native Mastra tools. - 4
Run with any model
Swap
openai("gpt-4o")for any AI SDK-compatible provider. Callagent.generate()and the agent routes tool calls through MCP automatically.
import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
const mcpClient = new MCPClient({
id: "fred-series-us-economic-time-series-mcp-client",
servers: {
"fred-series-us-economic-time-series-mcp": {
url: new URL(
"https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
),
},
},
});
const agent = new Agent({
name: "FRED Series — U.S. Economic Time Series Agent",
model: openai("gpt-4o"),
instructions: "You have access to FRED Series — U.S. Economic Time Series tools.",
tools: {
...(await mcpClient.listTools()),
},
});
const result = await agent.generate(
"List recent FRED Series — U.S. Economic Time Series transactions"
);
console.log(result.text); Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by FRED. 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.
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 FRED Series — U.S. Economic Time Series MCP in Mastra AI
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the FRED Series — U.S. Economic Time Series MCP today
We host it, we monitor it, we maintain it. You just paste one token.