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 ).

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.