econewsapi-mcp 0.4.0

MCP server for econewsapi — surface Brazilian financial news to Claude/AI agents

econewsapi-mcp

MCP server that exposes Brazilian financial news from econewsapi to Claude Desktop, Claude Code, and other Model Context Protocol compatible AI agents.

What it does

Lets you (or your AI agent) talk to econewsapi in natural language:

"Como tá o setor de petróleo hoje?" "Tem fato relevante novo da Vale?" "Quem foram os tickers mais comentados ontem?" "Sumarize os resultados anuais dos bancos"

Behind the scenes the agent picks the right tool, calls the API with HMAC-signed requests, and synthesizes a response.

Tools (v0.4.0)

Tool	What it does
search_news	Filter news by ticker / source / channel / scores / time window
get_news	Full content + summary + entities for one news item
trending_tickers	B3 tickers with highest news velocity
list_sectors	All B3 sectors (energy, financials, ...) with PT labels
list_tickers_by_sector	Resolve a sector to its B3 tickers (use before search_news)
list_topics	Curated news topics (commodities, dividends, M&A, ...)
sentiment_overview	Aggregate positive/negative/neutral counts for any filter slice
sentiment_trend	Sentiment evolution over time (bucketed) — improving/worsening detection

More tools coming: get_related_news, news_price_impact, calendar.

Install

pip install econewsapi-mcp

Or run directly without installing:

uvx econewsapi-mcp

Configure (Claude Desktop)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "econewsapi": {
      "command": "uvx",
      "args": ["econewsapi-mcp"],
      "env": {
        "ECONEWSAPI_API_KEY": "your-api-key",
        "ECONEWSAPI_API_SECRET": "your-api-secret"
      }
    }
  }
}

Restart Claude Desktop. Open a chat — the 🔧 icon should show econewsapi as a connected server.

Configure (Claude Code)

Add the same mcpServers block to ~/.claude/settings.json (or .claude/settings.json in a project) and restart Claude Code.

Configure (dev / local source)

{
  "mcpServers": {
    "econewsapi": {
      "command": "uvx",
      "args": ["--from", "/abs/path/to/EcoNewsApi-MCP", "econewsapi-mcp"],
      "env": { "ECONEWSAPI_API_KEY": "...", "ECONEWSAPI_API_SECRET": "..." }
    }
  }
}

Environment variables

name	required	default
ECONEWSAPI_API_KEY	yes	—
ECONEWSAPI_API_SECRET	yes	—
ECONEWSAPI_BASE_URL	no	https://news-api.economatica.com
ECONEWSAPI_LOG_LEVEL	no	INFO

Development

git clone <this-repo>
cd EcoNewsApi-MCP
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# run smoke test against prod (requires test API key)
export ECONEWSAPI_API_KEY=...
export ECONEWSAPI_API_SECRET=...
pytest tests/ -v

# run the MCP server manually to inspect stdio output
econewsapi-mcp

License

MIT