📅 ForexFactory MCP Server
An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as resources and tools.
Designed for use in agentic workflows, LLMs, and trading assistants.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as resources and tools.
Designed for use in agentic workflows, LLMs, and trading assistants.
An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as structured tools and resources for agentic workflows. Provides JSON-first access for LLMs, trading assistants, and automation platforms.
today, this_week, custom, etc.)This project is actively developed. The core functionality is stable (retrieving ForexFactory economic calendar events via MCP tools and resources), but we are still:
We welcome feedback and contributions while we continue building out the ecosystem.
forexfactory-mcp/
│── src/forexfactory_mcp/ # Main package
│ ├── models/ # Schemas & enums
│ ├── services/ # Scraper + data normalization
│ ├── tools/ # MCP tool definitions
│ ├── resources/ # MCP resource definitions
│ ├── prompts/ # Prompt templates (optional MCP prompts)
│ ├── utils/ # Shared helpers & config
│ └── server.py # FastMCP server entrypoint
│
│── examples/ # Example clients
│── tests/ # Unit tests
│── .env.example # Copy to .env for config
│── pyproject.toml # Dependencies & metadata
│── README.md # Documentation
│── .python-version # Python version pin (3.12)
(See repo for full details — this is a high-level layout for contributors.)
# Clone repo
git clone https://github.com/kjpou1/forexfactory-mcp.git
cd forexfactory-mcp
# Install dependencies
uv sync # or: pip install -e .
# Install Playwright browser binaries
uv run playwright install chromium
# or, if using pip/venv:
playwright install chromium
# Copy example environment and adjust if needed
cp .env.example .env
Start the server with default settings (stdio transport):
uv run ffcal-server
Run with HTTP transport:
uv run ffcal-server --transport http --host 0.0.0.0 --port 8080
uv run ffcal-server --transport sse --host 127.0.0.1 --port 8001
MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8080
Default namespace:
ffcal
Override via .env:
NAMESPACE=ffcal
Supported values:
today, tomorrow, yesterday, this_week, next_week, last_week, this_month, next_month, last_month, custom
All prompts support a style parameter to control formatting.
Default:
style: str = "bullet points"
See the Output Style Reference for available formats.
mcp call ffcal:get_calendar_events time_period=this_week
from mcp.client.session import Session
async with Session("ws://localhost:8000") as session:
result = await session.call_tool("ffcal:get_calendar_events", {"time_period": "today"})
print(result)
from langchain.agents import initialize_agent
from langchain_mcp import MCPToolkit
toolkit = MCPToolkit.from_server_url("ws://localhost:8000", namespace="ffcal")
agent = initialize_agent(toolkit.tools)
response = agent.run("What are today's USD-related high impact events?")
print(response)
Includes:
.envMCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8080
NAMESPACE=ffcal
Supports both stdio (default) and HTTP/SSE.
docker compose build
docker compose up forexfactory_mcp
Runs MCP server and exposes it on port 8000.
uv or dependency install failsRun:
docker compose build --no-cache forexfactory_mcp
Switch to:
make run-http
Change port:
docker compose run --rm -e MCP_PORT=8080 forexfactory_mcp
Install Chromium:
docker compose run forexfactory_mcp playwright install chromium
pytest -v
MIT License – see LICENSE for details.
An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as structured tools and resources for agentic workflows. Provides JSON-first access for LLMs, trading assistants
概览
An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as structured tools and resources for agentic workflows. Provides JSON-first access for LLMs, trading assistants, and automation platforms.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Forexfactory 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 An MCP (Model Context Protocol) server that exposes ForexFactory economic calendar data as structured tools and resources for agentic workflows. Provides JSON-first access for LLMs, trading assistants, and automation platforms.