Adios MCP
by Shame625
README.md
# Adios MCP: Croatian news for AI assistants
A free, read-only [Model Context Protocol](https://modelcontextprotocol.io) server for
[Adios](https://adios.hr), which brings together every major Croatian news portal in one place: one item per news story
with how many portals covered it, neutral summaries, where each story happened, stories followed over days, daily and
weekly summaries, trending topics and product recalls.
- **Endpoint:** `https://adios.hr/api/mcp` (Streamable HTTP)
- **No key, no sign-in, read-only**
- **Official MCP Registry:** `hr.adios/news`
- **Guide:** [adios.hr/developers/mcp](https://adios.hr/developers/mcp) (Croatian: [adios.hr/developeri/mcp](https://adios.hr/developeri/mcp))
The news is in Croatian. The server tells your AI so, and the AI answers you in your own language with a link to every
story it mentions.
## Connect
**Claude** (claude.ai, Claude Desktop): Settings → Connectors → Add custom connector, name `Adios`, URL
`https://adios.hr/api/mcp`. No OAuth is needed. Turn it on in a chat with "+" → Connectors.
**Claude Code**
```bash
claude mcp add --transport http adios-news https://adios.hr/api/mcp
```
**ChatGPT**: Settings → Apps & Connectors → Advanced → Developer mode, then Create: name `Adios`, MCP Server URL
`https://adios.hr/api/mcp`, authentication "No authentication". The server also has `search` and `fetch` in the shape
ChatGPT connectors and deep research look for.
**Codex**
```bash
codex mcp add adios_news --url https://adios.hr/api/mcp
```
**Cursor**: add to `~/.cursor/mcp.json` (or use the [`.mcp.json`](.mcp.json) in this repository):
```json
{
"mcpServers": {
"adios-news": { "url": "https://adios.hr/api/mcp" }
}
}
```
**VS Code** (GitHub Copilot): run "MCP: Add Server", choose HTTP and enter the URL, or add to `.vscode/mcp.json`:
```json
{
"servers": {
"adios-news": { "type": "http", "url": "https://adios.hr/api/mcp" }
}
}
```
**Windsurf** (`~/.codeium/windsurf/mcp_config.json`): `{"mcpServers": {"adios-news": {"serverUrl": "https://adios.hr/api/mcp"}}}`
**Gemini CLI** (`~/.gemini/settings.json`): `{"mcpServers": {"adios-news": {"httpUrl": "https://adios.hr/api/mcp"}}}`
## Tools
| Tool | What it does |
| --- | --- |
| `research_topic` | Everything connected to a question in one call: articles, followed stories, places on the map and the summaries that covered it |
| `get_latest_news` | The latest news, one item per story with how many portals covered it; filter by category, portal, period or badge; sort by time or coverage |
| `search_news` | Search by meaning and by words, best in Croatian ("požar Split", "cijene goriva"), with the same filters |
| `get_article` | One article in full: summary, background, topics, the same news on other portals, its place and the story it belongs to |
| `get_nearby_news` | News near a Croatian place or coordinates within a radius in km; `urgent_only` for fires, crashes and storms |
| `get_city_news` | The last 30 days of news of a Croatian city and its surroundings |
| `get_news_map` | Every located story of the last hours with coordinates, place and kind (fire, crash, crime, storm...) |
| `resolve_place` | A Croatian place name in any grammatical case to coordinates and county, or coordinates to the nearest town |
| `get_daily_digest` | The written summary of a day: sections, a timeline and the stories with links |
| `get_weekly_digest` | The written summary of a week (Monday to Sunday) |
| `list_stories` | Followed stories: news tracked over days or weeks as timelines of stages |
| `get_story_timeline` | One followed story from start to now: every stage with its time, summary and each portal's report |
| `get_trending_topics` | What Croatia is reading right now |
| `get_product_recalls` | Product recalls and food and consumer safety warnings (HAPIH, EU RASFF, Safety Gate); `lang=en` for English |
| `list_portals` | The portals Adios follows, with the slugs the filters take |
| `list_categories` | Article categories and map story kinds, with Croatian and English names |
| `get_my_usage` | The caller's limits and what is left of them today |
| `search`, `fetch` | Search and fetch by id, in the shape ChatGPT connectors and deep research look for |
Every tool is read-only and idempotent, has a title, an input schema and an output schema, and answers with both text
and `structuredContent`. Lists leave out filler (horoscopes, quizzes, celebrity gossip) unless `include_filler=true`.
The server also offers four ready prompts: `morning_briefing`, `local_news`, `explain_story` and `recall_check`.
## Try asking
- "What are the biggest stories in Croatia today?"
- "What is happening in and around Zadar, within 30 km?"
- "Explain the biggest story of this week from the beginning."
- "Any product recalls for baby food this month?"
- "Give me yesterday's summary, without world news."
## Protocol and limits
- Streamable HTTP with plain JSON answers.
- Protocol 2026-07-28 (stateless: `server/discover`, the version in every request's `_meta`, headers checked against
the body) and 2025-11-25 down to 2024-11-05 (opening with `initialize`).
- Free without a key. With `initialize`, each session has 20 calls a minute and 300 a day. A 2026-07-28 client has no
session and is counted per address: 120 calls a minute and 6,000 a day. A limit reached comes back as a tool error
that says when to try again.
- Discovery: [server card](https://adios.hr/api/mcp/server-card),
[AI catalog](https://adios.hr/.well-known/ai-catalog.json), [llms.txt](https://adios.hr/llms.txt) and the longer
[llms-full.txt](https://adios.hr/llms-full.txt).
Raw request examples: [examples/requests.md](examples/requests.md).
## Na hrvatskom
Besplatan MCP poslužitelj [Adiosa](https://adios.hr): hrvatske vijesti sa svih većih portala na jednom mjestu, najnovije
i najveće priče, vijesti oko bilo kojeg mjesta, pregledi dana i tjedna, kronologije priča, teme u trendu i opozivi
proizvoda. Adresa je `https://adios.hr/api/mcp`, bez ključa i bez prijave, samo za čitanje. Upute za ChatGPT, Claude,
Cursor, VS Code i druge su na [adios.hr/developeri/mcp](https://adios.hr/developeri/mcp).
## Rules, privacy, support, license
- Show headlines, short summaries and links. The full texts belong to the portals that published them.
[Terms](https://adios.hr/developers/terms), [privacy](https://adios.hr/privatnost).
- Questions and bug reports: contact@adios.hr or an issue in this repository.
- The files in this repository are MIT licensed. The news belongs to its publishers; the summaries, the map and the
timelines are [Adios](https://adios.hr)'s.