BlinkHub Wire

BlinkHub Wire — government news API and MCP server

Government press releases from six markets, ready to run: the United States, Korea, the United Kingdom, the European Union, New Zealand and Australia. Pull them over a REST API as IPTC ninjs 2.1, or connect an AI assistant through the MCP server and let it search and read them for you.

Base URL https://wire.blinkhub.net · MCP https://wire.blinkhub.net/mcp · Auth X-Api-Key header · Free tier 100 full articles a month · Docs https://blinkhub.net/en/korean-news-api

curl -H "X-Api-Key: $BLINK_WIRE_KEY" \
  "https://wire.blinkhub.net/api/wire/v1/articles?market=gb&limit=20"

What is in it

Every document carries the attribution line it needs in copyrightnotice. Sources whose terms do not allow commercial redistribution are left out of the feed.

Getting a key

1. Register your publication at https://blinkhub.net/en/publishers/join (free account).
2. In the portal, open Wire: add your site, fill in your publication details, agree to the terms and verify the site (a meta tag or a text file).
3. We review and approve the publication, and you are emailed when it is approved.
4. Copy your key from the portal. It is shown once; you can rotate it from the same screen.

The free tier covers 100 full articles a month. For higher volumes, write to contact@blinkhub.net.

Use it from an AI assistant (MCP)

The MCP server speaks Streamable HTTP at https://wire.blinkhub.net/mcp and takes your key in the X-Api-Key header (or Authorization: Bearer <key>).

Claude Code

claude mcp add --transport http blinkhub-wire https://wire.blinkhub.net/mcp \
  --header "X-Api-Key: $BLINK_WIRE_KEY"

Any client that reads an mcpServers config

{
  "mcpServers": {
    "blinkhub-wire": {
      "type": "http",
      "url": "https://wire.blinkhub.net/mcp",
      "headers": { "X-Api-Key": "YOUR_KEY" }
    }
  }
}

Then ask in plain language — "Find this week's UK government announcements on energy and summarise the top one, with the attribution line."

Search Korean articles with Korean keywords (for example 반도체, 수출).

Also listed in the official MCP Registry as net.blinkhub/wire.

REST endpoints

Listing

GET /api/wire/v1/articles?market=gb&limit=20&since=2026-10-01T00:00:00Z

market defaults to us. limit is 1–100 (default 20). since returns only what appeared after that time, so a scheduled job can ask for what is new since its last run.

{
  "market": "us",
  "count": 1,
  "items": [
    {
      "uri": "urn:blink:wire:us:48211",
      "id": "48211",
      "headline": "NASA Selects Instruments for Lunar Surface Mission",
      "description_text": null,
      "source": "NASA",
      "versioncreated": "2026-09-25T22:10:04.120000+09:00",
      "has_image": true,
      "body_chars": 4180,
      "already_taken": false
    }
  ]
}

already_taken tells you whether this key has fetched that article before — if it has, fetching it again is free.

Fetching one

GET /api/wire/v1/articles/{id}?market=us

Returns a ninjs 2.1 document. Bodies are cleaned of site furniture (newsletter prompts, share rows, duplicated blocks) and image URLs point at public addresses. Non-standard fields are kept under x_blink so a standards-compliant consumer can ignore them. Korean articles embargoed by the issuing body stay hidden until the embargo time.

Billing

• Listing and searching are free. See what exists before you take any of it.
• A full fetch counts once — the first time this key takes a given article.
• Re-fetching is free. After a crash, during a re-index, from a second system.
• Nothing is counted for an article we refuse to serve. The quality gate runs first.

Errors

All errors share one shape:

{ "error": { "code": "quota_exceeded", "message": "..." } }

WordPress

The BlinkHub Wire Importer plugin imports articles into WordPress on a schedule and reports publications back automatically.

Examples

• examples/fetch.py — Python, standard library only
• examples/fetch.mjs — Node 18+, no dependencies
• openapi.yaml — OpenAPI 3.1 description of the REST API

Both examples list what is new since a timestamp, then fetch only the articles this key has not taken before. Pass --market gb (or any market code) to read another feed.

Licence

The code in this repository is MIT (see LICENSE). The articles are not: each document's copyrightnotice and usageterms fields state the terms that apply.