get_news_by_engine

Retrieve cryptocurrency news articles filtered by specific content types including news, listings, onchain data, memes, and market updates.

Instructions

Get news articles filtered by engine type.

Engine types: "news", "listing", "onchain", "meme", "market".

Args: engine_type: The engine type code. limit: Maximum results (default 10, max 100).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`engine_type`	Yes
`limit`	No

Implementation Reference

src/opennews_mcp/tools/news.py:101-121 (handler)

The main handler function get_news_by_engine that filters news articles by engine type. It uses the @mcp.tool() decorator for registration, retrieves the API client from context, calls api.search_news with the engine_type filter, and returns a standardized response with success status, data, count, and total.

@mcp.tool()
async def get_news_by_engine(engine_type: str, ctx: Context, limit: int = 10) -> dict:
    """Get news articles filtered by engine type.

    Engine types: "news", "listing", "onchain", "meme", "market".

    Args:
        engine_type: The engine type code.
        limit: Maximum results (default 10, max 100).
    """
    api = ctx.request_context.lifespan_context.api
    limit = clamp_limit(limit)
    try:
        result = await api.search_news(engine_types={engine_type: []}, limit=limit, page=1)
        data = result.get("data", [])[:limit]
        return make_serializable({
            "success": True, "engine_type": engine_type, "data": data,
            "count": len(data), "total": result.get("total", 0),
        })
    except Exception as e:
        return {"success": False, "error": str(e) or repr(e)}

src/opennews_mcp/tools/news.py:101-101 (registration)
The @mcp.tool() decorator registers the get_news_by_engine function as an MCP tool, making it available to clients via the Model Context Protocol.
```
@mcp.tool()
```
src/opennews_mcp/config.py:38-40 (helper)
The clamp_limit helper function validates and clamps the user-supplied limit parameter to the range [1, MAX_ROWS], ensuring safe API queries.
```
def clamp_limit(limit: int) -> int:
    """Clamp user-supplied limit to [1, MAX_ROWS]."""
    return min(max(1, limit), MAX_ROWS)
```

src/opennews_mcp/config.py:43-57 (helper)

The make_serializable helper function recursively converts non-JSON-serializable types (datetime, Decimal, bytes) to JSON-compatible formats, ensuring clean API responses.

def make_serializable(obj):
    """Recursively convert non-JSON-serializable types."""
    if obj is None:
        return None
    if isinstance(obj, dict):
        return {k: make_serializable(v) for k, v in obj.items()}
    if isinstance(obj, (list, tuple)):
        return [make_serializable(item) for item in obj]
    if isinstance(obj, (datetime, date)):
        return obj.isoformat()
    if isinstance(obj, Decimal):
        return float(obj)
    if isinstance(obj, bytes):
        return obj.decode("utf-8", errors="replace")
    return obj

src/opennews_mcp/api_client.py:78-99 (helper)

The search_news method in NewsAPIClient performs the actual REST API call to POST /open/news_search, accepting engine_types as a filter and returning raw article data from the 6551 news platform.

async def search_news(
    self,
    coins: Optional[list[str]] = None,
    query: Optional[str] = None,
    engine_types: Optional[dict[str, list[str]]] = None,
    has_coin: bool = False,
    limit: int = 20,
    page: int = 1,
) -> dict:
    """POST /open/news_search — 搜索新闻文章"""
    body: dict[str, Any] = {"limit": limit, "page": page}
    if coins:
        body["coins"] = coins
    if query:
        body["q"] = query
    if engine_types:
        body["engineTypes"] = engine_types
    if has_coin:
        body["hasCoin"] = has_coin

    resp = await self._request("POST", f"{self.base_url}/open/news_search", json=body)
    return resp.json()

OpenNews MCP