plainradar

Blog / AI agents

How to give your AI agent live news with MCP.

· 6 min read

Language models know the world up to their training cutoff. Ask one what happened this morning and it either guesses or runs a generic web search. A news MCP server gives your agent a proper tool for that. Here's how to connect one to Claude, Cursor or any other MCP client in a few minutes, and how to get good results from it.

Why an agent needs a news tool

The Model Context Protocol (MCP) is the standard way to give an AI agent tools it can call. Most agents already have a web search tool, so why add another?

Plainradar's MCP server exposes one tool, search_news. It runs the same live search as plainradar.com: it reads the best-matching news sites and blogs in 45 languages, groups duplicate coverage, ranks the stories and returns only those an AI check confirmed as relevant. A call usually takes a few seconds.

The quick way: sign in

Clients that support sign-in (OAuth) need only the address. Add https://plainradar.com/mcp as a remote MCP server and the client opens a Plainradar page where you press Allow. If you don't have an account yet, enter your email there and open the link we send: that creates your free account, which includes agent access. There's no token to copy.

The app then shows under Account → Agent tokens, where you can disconnect it at any time. If your client asks for a header instead, or you're writing your own agent, use a token as described next.

Step 1: create a token

Sign up at plainradar.com (the free plan includes agent access), open Account → Agent tokens and press Create token. Copy it right away, because it's only shown once. Treat it like a password and keep it out of shared repositories. You can revoke it from the same page at any time.

The connection details are:

Endpoint: https://plainradar.com/mcp
Header:   Authorization: Bearer YOUR_TOKEN

The Connect an agent button at the top of the site shows the same details, with your token already filled in once you're logged in.

Step 2: add it to your client

Claude Code

One command, run in your terminal:

claude mcp add --transport http plainradar https://plainradar.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Then start Claude Code and run /mcp to check that plainradar is connected.

Cursor

Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "plainradar": {
      "url": "https://plainradar.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Claude Desktop and clients that only run local servers

If your client can only start local (stdio) servers, use the mcp-remote bridge. It needs Node.js. In Claude Desktop, open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "plainradar": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://plainradar.com/mcp",
               "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

Restart the app and the tool shows up in the tools menu. The same command works in any client that takes a command line:

npx -y mcp-remote https://plainradar.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Your own agent

Any MCP SDK that speaks streamable HTTP can connect: point it at the endpoint and send the header. The server is stateless and returns JSON, so it works behind proxies and in serverless functions.

What the tool returns

Here's a real response for electric vehicle batteries, trimmed to one story:

{
  "query": "electric vehicle batteries",
  "pages": [{
    "from": "2026-10-04T20:06:18Z",
    "to":   "2026-10-05T20:06:18Z",
    "stories": [{
      "title": "BMW Opens New €1 Billion Battery Plant in Germany to Supply New BMW i3",
      "link": "https://electriccarsreport.com/2026/10/bmw-opens-new-e1-billion-battery-plant-...",
      "published": "2026-10-05T07:45:12+00:00",
      "feed": "Electric Cars Report",
      "summary": "BMW has officially opened its new battery production plant in Irlbach-Straßkirchen, ...",
      "sources": 2,
      "relevant": "yes"
    }],
    "more": true,
    "cursor": "4AVB58NmZD6qxnbf:day"
  }]
}

That search returned 11 stories that passed the relevance check, in about six seconds. Each story has its headline, link, source, publication time, summary, image and how many sources covered it.

Parameters

ParameterWhat it does
queryThe topic or question, in plain language (2–200 characters).
days1 by default. 2–7 adds a second page with the best stories from the days before the last 24 hours.
languageSources are English by default. Use a language name such as "French", or "all" for every language. A language or country named in its own language in the query ("España", "română") works too.
filtersUp to 5 plain-language preferences, such as "Skip opinion pieces and listicles" or "Only news from Europe". Give them on the first call. They then apply to the whole search.
limitThe most stories a page has: 30 by default, up to 100. The most covered and most relevant stories come first, and omitted says how many more there were.
cursorWhen a page says more: true, call again with the same query and this cursor for further stories. You get new stories plus updates (more coverage) for ones already returned.

Prompts that work well

The agent decides when to call the tool, so you can just ask normally. Some examples:

Tips: ask for sources, so the agent keeps the links. For broad topics, let it follow the cursor once or twice. A higher sources count usually means a bigger story.

Credits and limits

Agent access is included in the free plan and uses the same credits as the website: each new query uses one credit. Cursor pages and filters within that query are included. Every response includes credits_left, so your agent can keep track of usage. Calls are rate-limited per account to keep the service fast for everyone.

Create a token and connect your agent. It takes about two minutes.

Get your token →

FAQ

What is a news MCP server?

An MCP (Model Context Protocol) server gives an AI agent tools it can call. A news MCP server gives it a tool for searching current news, so the agent can answer questions about what happened today instead of relying on its training data.

Isn't the web search tool built into my AI enough?

Web search returns pages ranked for the whole web, often evergreen articles, and the agent has to open and judge them. A news tool returns only recent stories, already grouped and checked for relevance, with sources and publication times, so the agent spends its effort on the answer.

How much does it cost?

Agent access is included in Plainradar's free plan. Each new query uses one credit, the same as a search on the website. Paging through more results of the same query with its cursor and applying filters are included.

Which MCP clients work?

Any client that supports remote (streamable HTTP) MCP servers. Clients with sign-in (OAuth), such as Claude, need only the address; others send a token in a header. Clients that only run local servers can connect through the mcp-remote bridge, which needs Node.js.