# Mukoko News

> Pan-African news & analytics for Zimbabwe and 15 African countries: briefings and trends.

- name: io.github.nyuchi/mukoko-news
- version: 1.2.0
- connection class: R0 (autonomous)
- trust: 89/100
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.nyuchi%2Fmukoko-news
- tools: https://api.protogrid.dev/v1/servers/io.github.nyuchi%2Fmukoko-news/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "mukoko-news": {
      "type": "http",
      "url": "https://news.mukoko.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 98
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-95% ~updated-112d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 83/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_sources (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); detect_surge (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_location_news (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,663 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 1 resolved packages
- n/a `deps.mcp_sdk_version`: the official MCP SDK is not in the dependency graph
- pass `deps.resolvable`: @nyuchi/mukoko-news-mcp@1.2.0 resolved: 1 packages

- tools: 16, about 1,663 tokens to load them all
- tool set hash: f9ba690173a73a89f69e3acae659061d
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.nyuchi/mukoko-news.svg)](https://protogrid.dev/servers/io.github.nyuchi/mukoko-news)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm @nyuchi/mukoko-news-mcp@1.2.0: resolved, 0 dependencies

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://news.mukoko.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.9478261)

## Packages

- npm @nyuchi/mukoko-news-mcp@1.2.0

## Tools (16)

- `compare_locations`: Compare news coverage between 2–4 African countries or regions side by side.
- `detect_surge`: Detect sudden spikes in news coverage — compares last 24h against 7-day baseline. Surfaces unusual increases like crime up 5× in Bulawayo or a football surge in Ghana.
- `drain_enrichment_backlog`: Drain the ENTIRE un-enriched article backlog, not just one batch. RESTRICTED to platform-team accounts (WorkOS bearer issued inside the platform-team org). Fire-and-forget: asks the pipeline worker to enrich un-enriched articles in batches (oldest first) until the backlog is clear, running independently of the automatic 10-minute sweep. Returns immediately; use trigger_enrichment for a single targeted batch instead.
- `find_stories`: Search articles by keyword, tag, category, or country. Results carry short excerpts, word counts, and app links only — call get_article with a result's id to read the full article body inline.
- `get_article`: Read a single article by ID or slug. Returns the full article body inline as markdown (truncated at ~8000 characters with a link to continue in the app) plus source metadata and the Mukoko app URL. Use this after a list tool (get_briefing, find_stories, …) to read an article without leaving the conversation.
- `get_briefing`: Answer "What's happening in [place/topic]?" — top story, recent articles, and trending topics in one call. Accepts country codes (ZW, KE), region names (East Africa, Southern Africa), category topics (politics, business), or omit focus for a pan-African overview. Returns short excerpts with word counts and app links only — call get_article with an article id to read a full article body inline.
- `get_content_analytics`: Open data breakdown of news coverage by category, country, and keyword for a given period.
- `get_location_news`: News from a specific place in Africa. Accepts country codes, country names, region names, or city names.
- `get_my_feed`: Personalised news feed based on the authenticated user's article likes and saves. Requires Authorization: Bearer <WorkOS access token>.
- `get_source_view`: See how a specific news source is covering a topic.
- `get_stats`: Platform statistics: total articles, active sources, and today's output.
- `get_trending_analytics`: Open analytics: trending topics, categories, keywords, and sources for any location or period. Part of Mukoko's open data policy.
- `list_categories`: List all news categories with article counts.
- `list_sources`: List active news sources. Optionally filter by country code.
- `track_story`: Follow the development of a news story over time. Returns articles in chronological order showing how a story evolved. Use since to control the lookback window.
- `trigger_enrichment`: Manually run the AI enrichment agent over existing articles (classification, keywords, entities, quality scoring). RESTRICTED to platform-team accounts — requires a WorkOS bearer token issued inside the platform-team org. By default enriches the most recent un-enriched articles; pass article_ids to target specific ones, or reset_attempts to re-run articles that previously hit the failure cap.
