📅 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.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
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
Visão geral
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.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Forexfactory roda localmente via stdio.
Última verificação: 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.