Installation
npm package:
@alphacast/mcp. Run it with npx -y @alphacast/mcp — your MCP client spawns it as a local subprocess. Authenticate by setting the ALPHACAST_API_KEY environment variable.What you can do
Discover data
Search the curated Alphacast catalog. Browse 30+ providers — FRED, BLS, World Bank, OECD, IMF, BIS, ECB, Eurostat, Banxico, and many more — without learning each provider’s native API.
Read datasets
Download dataset rows in CSV or JSON, fetch column schemas, and inspect repository metadata. The Home repository is resolved automatically when you don’t specify one.
Look up tickers
Search public market tickers, ETFs, indexes, and ISINs, then pull historical OHLCV prices over
5y, ytd, max, and other lookback periods.Build pipelines
Create pipelines, add or edit steps, run them, and preview the output of any step. Auto-validates and auto-runs after every mutation.
Browse providers
Walk hierarchical catalogs, search series by keyword, and preview or fetch full historical data.
Author charts
Look up chart-authoring recipes for any Grapher chart type, validate configurations before saving, and inspect existing chart metadata.
Get started
Quickstart
Connect a client and run your first prompt in under five minutes.
Configuration
Step-by-step setup for Claude Desktop, Claude Code, Cursor, and other clients.
Tools reference
All 32 tools, grouped by capability, with input schemas and example prompts.
Examples
End-to-end walkthroughs that combine multiple tools to solve real research workflows.
Safety boundaries
The server intentionally does not expose destructive operations. Repositories, datasets, and pipelines can only be deleted from the Alphacast web UI — never from an agent. Of the 32 tools, 28 are read-only; the 4 write tools (create_pipeline, add_pipeline_step, edit_pipeline_step, delete_pipeline_step) are scoped to pipeline authoring. Provider API keys are managed through the Alphacast settings web UI.