mcp

Free, cross-lingual compact news briefings for AI agents — across 89 languages, in one call.

ClarityBriefs exposes a hosted, read-only Model Context Protocol (MCP) server so AI agents and assistants can pull token-efficient news briefings on any topic — including foreign-language news pools an English-only agent can't easily reach.

• Endpoint: https://claritybriefs.com/api/mcp
• Transport: Streamable HTTP · JSON-RPC 2.0 · MCP spec 2025-11-25
• Auth: none for the public tools (anonymous). An optional Bearer API key unlocks Pro briefing-management tools.
• Cost to you: free, attribution-based. Training / bulk use is licensed (RSL 1.0).
• Docs: https://claritybriefs.com/agents · llms.txt: https://claritybriefs.com/llms.txt · OpenAPI: https://claritybriefs.com/api/agent/openapi.json

Tools (public, no auth)

Tool	What it does
get_compact_brief	Compact briefing on a topic. Cross-lingual: pass source_languages (e.g. ["ko","ja","de"]) to also search foreign news pools — each article tagged with its source language.
search_news	Recent news headlines + sources for a topic.
suggest_topics	Popular public topics to brief on.

A Pro API key (sent as Authorization: Bearer <key>) additionally unlocks briefing-management tools (list / preview / create / pause / resume / rename).

Connect from Claude Desktop

Claude Desktop talks to local (stdio) MCP servers, so use the mcp-remote bridge to reach this hosted HTTP server. Requires Node.js.

Edit your claude_desktop_config.json (Settings → Developer → Edit Config) and add:

{
  "mcpServers": {
    "claritybriefs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://claritybriefs.com/api/mcp"]
    }
  }
}

For the Pro tools, add your API key:

{
  "mcpServers": {
    "claritybriefs": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://claritybriefs.com/api/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Quit Claude Desktop fully (Cmd+Q) and reopen. The tools appear under the connectors / tools icon.

Call it directly (any MCP client)

curl -s https://claritybriefs.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1,"params":{
        "name":"get_compact_brief",
        "arguments":{"topic":"artificial intelligence regulation","language":"en","source_languages":["ko","ja","de"],"limit":6}}}'

Each returned article includes headline, summary, source, url, language, published.

Terms

• ✅ Search & AI answers — free, please attribute claritybriefs.com with a link when citing.
• 📄 AI training / bulk use — licensed: RSL 1.0 (ai-train=no).
• Returns original third-party source URLs — please cite the original publishers too.

Links

• Website: https://claritybriefs.com
• Agent docs: https://claritybriefs.com/agents
• OpenAPI: https://claritybriefs.com/api/agent/openapi.json
• Contact / licensing: [email protected]

---

This repository is a connector manifest for the hosted ClarityBriefs MCP server. The server itself is operated at https://claritybriefs.com/api/mcp.