From bdb5aa0ddbe398ec23bd147fba79ad1ae817762a Mon Sep 17 00:00:00 2001 From: Bohdan Denysiuk Date: Mon, 5 Oct 2026 17:16:41 +0300 Subject: [PATCH] Agent setup page: make the Step 3 test query a search_articles call "Latest headlines about renewable energy" pointed an agent at get_latest_headlines, which has no q parameter and rejects one with a validation error. Say that only search_articles takes a keyword and show the example as the exact call, verified against the hosted server. Co-Authored-By: Claude Opus 5.5 --- news-api/integrations/mcp-agent-setup.mdx | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/news-api/integrations/mcp-agent-setup.mdx b/news-api/integrations/mcp-agent-setup.mdx index 61eb810..048369a 100644 --- a/news-api/integrations/mcp-agent-setup.mdx +++ b/news-api/integrations/mcp-agent-setup.mdx @@ -168,10 +168,28 @@ client restart. Claude Desktop does **not** need it; use path A. Ask for `check_health` (free, proves the connection), then `get_subscription` (proves the key, shows quota). Then one real query that names a time window, a -result count and the fields wanted, so the response stays small: "Latest -headlines about renewable energy, last 2 days, 10 results, title, link, date +result count and the fields wanted, so the response stays small: "Most recent +articles about renewable energy, last 2 days, 10 results, title, link, date and source only." +A topic means a keyword, and only `search_articles` takes one (`q`). +`get_latest_headlines` has no `q` and rejects it with a validation error; it +filters by `lang`, `countries`, `theme` and `sources` over a `when` window. +The query above as a call: + +```json +{ + "name": "search_articles", + "arguments": { + "q": "\"renewable energy\"", + "from_": "2 days ago", + "sort_by": "date", + "page_size": 10, + "fields": ["title", "link", "published_date", "domain_url"] + } +} +``` + ## Defaults that decide what comes back - **Time window: the last 7 days.** Anything older needs explicit `from_` and