# OpenNews MCP Server — Usage Guide

## Overview

This MCP server provides access to crypto news from the 6551 news platform
via REST API and WebSocket. It replaces direct database access with API calls.

## Available Tools

### Discovery
- **get_news_sources**: Get all available news source categories (Bloomberg, Reuters, etc.)
- **list_news_types**: Flat list of news type codes for filtering

### News Search
- **get_latest_news**: Get most recent news (no filters)
- **search_news**: Search by keyword
- **search_news_by_coin**: Search by coin symbol (BTC, ETH, SOL, etc.)
- **get_news_by_source**: Filter by source (Bloomberg, Reuters, Coindesk, etc.)
- **get_news_by_engine**: Filter by engine type (news, listing, onchain, meme, market)
- **search_news_by_date**: Search within a date range

### AI Ratings
- **get_high_score_news**: Get articles with high AI scores (>=70)
- **get_news_by_signal**: Filter by trading signal (long/short/neutral)

### Real-time
- **subscribe_latest_news**: Connect to WebSocket for live news updates

## Workflow Examples

1. **Quick market overview**: `get_latest_news(limit=10)`
2. **Coin-specific research**: `search_news_by_coin(coin="BTC", limit=20)`
3. **Source-specific feed**: `get_news_by_source(source="Bloomberg")`
4. **Bullish signals**: `get_news_by_signal(signal="long")`
5. **High-impact news**: `get_high_score_news(min_score=80)`

## Data Structure

Each news article contains:
- `id`: Unique article ID
- `text`: Article headline/content
- `newsType`: Source type (Bloomberg, Reuters, etc.)
- `engineType`: Engine category (news, listing, onchain, etc.)
- `link`: URL to original article
- `coins`: Array of related coins with symbol, market_type, match
- `aiRating`: AI analysis with score, grade, signal, summary, enSummary
- `ts`: Timestamp of the article