com.claritybriefs/mcp
Free cross-lingual news briefings for AI agents across 89 languages. Read-only, hosted.
Open source Repository Open in the app JSON README (API)
About
Free cross-lingual news briefings for AI agents across 89 languages. Read-only, hosted.
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- com.claritybriefs
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-22T18:51:38Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 03:01:02
- Updated
- 2026-08-29 03:01:02
- Origin id
com.claritybriefs/mcp
README
# ClarityBriefs MCP Server
> Free, **cross-lingual** compact news briefings for AI agents — across **89 languages**, in one call.
[ClarityBriefs](https://claritybriefs.com) 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](https://claritybriefs.com/license.xml)).
- **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`](https://www.npmjs.com/package/mcp-remote) bridge to reach this hosted HTTP server. Requires [Node.js](https://nodejs.org).
Edit your `claude_desktop_config.json` (Settings → Developer → Edit Config) and add:
```json
{
"mcpServers": {
"claritybriefs": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://claritybriefs.com/api/mcp"]
}
}
}
```
For the Pro tools, add your API key:
```json
{
"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)
```bash
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](https://claritybriefs.com/license.xml) (`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: info@claritybriefs.com
---
*This repository is a connector manifest for the hosted ClarityBriefs MCP server. The server itself is operated at `https://claritybriefs.com/api/mcp`.*