opennews-mcp/docs/README_EN.md

OpenNews MCP Server
Crypto News Aggregation · AI Ratings · Trading Signals · Real-time Feeds

日本語 | 한국어

---

Quick Install

First, go to https://6551.io/mcp to get your API Token.

Claude Code

claude mcp add opennews \
  -e OPENNEWS_TOKEN=<your-token> \
  -- uv --directory /path/to/opennews-mcp run opennews-mcp

Replace /path/to/opennews-mcp with your local project path, and <your-token> with your Token.

OpenClaw

export OPENNEWS_TOKEN="<your-token>"
cp -r openclaw-skill/opennews ~/.openclaw/skills/

---

Let AI Review & Install For You

Not sure if this MCP is safe? Paste the prompt below to your AI assistant — it will review the source code first, then install if safe:

Copy this prompt and send it to your AI assistant (replace <project-path> and <your-token> with actual values):

Please review and install the opennews-mcp MCP server for me. The project is at <project-path>.

Steps:
1. Review these files for security:
   - src/opennews_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
   - src/opennews_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
   - src/opennews_mcp/tools/*.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
   - pyproject.toml — Confirm dependencies are only mcp, httpx, websockets, no suspicious packages
2. Tell me your conclusion: safe / risky / problematic, with specific reasons
3. If safe, run the install (get Token from https://6551.io/mcp):
   claude mcp add opennews -e OPENNEWS_TOKEN=<your-token> -- uv --directory <project-path> run opennews-mcp

---

What Can It Do?

Once connected, just ask your AI assistant:

You say	It does
"Latest crypto news"	Fetches newest articles
"Search for SEC regulation news"	Full-text keyword search
"BTC related news"	Filter by coin
"Bloomberg articles"	Filter by source
"On-chain events"	Filter by engine type (onchain)
"High-impact news, AI score above 80"	High-score filtering
"Bullish signals"	Filter by trading signal (long)
"Subscribe to live news"	WebSocket real-time feed

---

Available Tools

Category	Tool	Description
Discovery	get_news_sources	All news source categories as a tree
	list_news_types	All available source codes
Search	get_latest_news	Latest articles
	search_news	Keyword search
	search_news_by_coin	By coin (BTC, ETH, SOL...)
	get_news_by_source	By engine type and source (requires engine_type and news_type)
	get_news_by_engine	By type (news, listing, onchain, meme, market)
	search_news_advanced	Advanced search (multiple filters)
AI	get_high_score_news	Articles with score >= threshold
	get_news_by_signal	By signal: long / short / neutral
Real-time	subscribe_latest_news	WebSocket live collection

---

Configuration

Get API Token

Go to https://6551.io/mcp to get your API Token.

Set the environment variable:

# macOS / Linux
export OPENNEWS_TOKEN="<your-token>"

# Windows PowerShell
$env:OPENNEWS_TOKEN = "<your-token>"

Variable	Required	Description
OPENNEWS_TOKEN	Yes	6551 API Bearer Token (get from https://6551.io/mcp)
OPENNEWS_API_BASE	No	Override REST API URL
OPENNEWS_WSS_URL	No	Override WebSocket URL
OPENNEWS_MAX_ROWS	No	Max results per query (default: 100)

Also supports config.json in the project root (env vars take precedence):

{
  "api_base_url": "https://ai.6551.io",
  "wss_url": "wss://ai.6551.io/open/news_wss",
  "api_token": "<your-token>",
  "max_rows": 100
}

---

Data Structure

Each article:

{
  "id": "unique-article-id",
  "text": "Headline / content",
  "newsType": "Bloomberg",
  "engineType": "news",
  "link": "https://...",
  "coins": [{ "symbol": "BTC", "market_type": "spot", "match": "title" }],
  "aiRating": {
    "score": 85,
    "grade": "A",
    "signal": "long",
    "status": "done",
    "summary": "Chinese summary",
    "enSummary": "English summary"
  },
  "ts": 1708473600000
}

AI Field	Description
score	0-100 impact rating
signal	long (bullish) / short (bearish) / neutral
status	done = AI analysis complete

---

Other Clients — Manual Install (click to expand)

In all configs below, replace /path/to/opennews-mcp with your actual local project path, and <your-token> with your Token from https://6551.io/mcp.

Claude Desktop

Edit config (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "opennews": {
      "command": "uv",
      "args": ["--directory", "/path/to/opennews-mcp", "run", "opennews-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json or Settings > MCP Servers:

{
  "mcpServers": {
    "opennews": {
      "command": "uv",
      "args": ["--directory", "/path/to/opennews-mcp", "run", "opennews-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "opennews": {
      "command": "uv",
      "args": ["--directory", "/path/to/opennews-mcp", "run", "opennews-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cline

VS Code sidebar > Cline > MCP Servers > Configure, edit cline_mcp_settings.json:

{
  "mcpServers": {
    "opennews": {
      "command": "uv",
      "args": ["--directory", "/path/to/opennews-mcp", "run", "opennews-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue.dev

~/.continue/config.yaml:

mcpServers:
  - name: opennews
    command: uv
    args:
      - --directory
      - /path/to/opennews-mcp
      - run
      - opennews-mcp
    env:
      OPENNEWS_TOKEN: <your-token>

Cherry Studio

Settings > MCP Servers > Add > Type stdio: Command uv, Args --directory /path/to/opennews-mcp run opennews-mcp, Env OPENNEWS_TOKEN.

Zed Editor

~/.config/zed/settings.json:

{
  "context_servers": {
    "opennews": {
      "command": {
        "path": "uv",
        "args": ["--directory", "/path/to/opennews-mcp", "run", "opennews-mcp"],
        "env": {
          "OPENNEWS_TOKEN": "<your-token>"
        }
      }
    }
  }
}

Any stdio MCP client

OPENNEWS_TOKEN=<your-token> \
  uv --directory /path/to/opennews-mcp run opennews-mcp

---

Compatibility

Client	Install Method	Status
Claude Code	claude mcp add	One-liner
OpenClaw	Copy skill directory	One-liner
Claude Desktop	JSON config	Supported
Cursor	JSON config	Supported
Windsurf	JSON config	Supported
Cline	JSON config	Supported
Continue.dev	YAML / JSON	Supported
Cherry Studio	GUI	Supported
Zed	JSON config	Supported

---

Related Projects

• twitter-mcp - Twitter/X data MCP server

---

Development

cd /path/to/opennews-mcp
uv sync
uv run opennews-mcp

# MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/opennews-mcp run opennews-mcp

Project Structure

├── README.md
├── docs/
│   ├── README_EN.md           # English
│   ├── README_JA.md           # 日本語
│   └── README_KO.md           # 한국어
├── openclaw-skill/opennews/   # OpenClaw Skill
├── knowledge/guide.md         # Embedded knowledge
├── pyproject.toml
├── config.json
└── src/opennews_mcp/
    ├── server.py              # Entry point
    ├── app.py                 # FastMCP instance
    ├── config.py              # Config loader
    ├── api_client.py          # HTTP + WebSocket
    └── tools/                 # Tools

License

MIT