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.5.0)

More tools coming: get_related_news, news_price_impact.

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": {
    "economatica": {
      "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 Economatica News as a connected server.

Note: the package name (econewsapi-mcp) and the env vars (ECONEWSAPI_*) keep the legacy econewsapi prefix for backward compatibility. The display name and config key (economatica) reflect the parent brand.

Configure (Claude Code)

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

Updating

uvx caches packages aggressively — a Claude Desktop restart alone won't pick up a new release. Three ways to upgrade:

Option A — Pin the version (recommended for prod):

"args": ["econewsapi-mcp@0.5.0"]

Edit the JSON each time you bump. Deterministic — no cache surprises.

Option B — Always-fresh (dev-friendly, ~1-2s cold start cost):

"args": ["--refresh", "econewsapi-mcp"]

uvx checks PyPI for newer versions on every Claude Desktop launch.

Option C — One-shot manual refresh (keep config simple):

uvx --refresh econewsapi-mcp --help
# or just bust the cache:
uv cache clean econewsapi-mcp

Then restart Claude Desktop. Next launch picks up the new version.

If you installed via uv tool install:

uv tool upgrade econewsapi-mcp

If you installed via pip in a venv:

pip install --upgrade econewsapi-mcp

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

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