# mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Volkanyalc/claritybriefs-mcp-connector  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-72

## Description
Free cross-lingual news briefings for AI agents across 89 languages. Read-only, hosted.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation & 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`.*

