Skip to content

Agent setup page: make the Step 3 test query a search_articles call - #156

Open
bohdan-debug wants to merge 1 commit into
mainfrom
docs/agent-setup-step3-example
Open

bohdan-debug wants to merge 1 commit into
mainfrom
docs/agent-setup-step3-example

Conversation

@bohdan-debug

Copy link
Copy Markdown
Collaborator

Step 3 of the hidden agent setup page (news-api/integrations/mcp-agent-setup) suggested the test query "Latest headlines about renewable energy". An agent following the page took that literally and called get_latest_headlines with q, which the server rejects:

1 validation error for call[get_latest_headlines]
q
  Unexpected keyword argument

Only search_articles takes a keyword. This PR:

  • rewords the example to "Most recent articles about renewable energy"
  • says outright that a topic means q, which only search_articles has, and what get_latest_headlines filters on instead
  • shows the example as the exact search_articles call (from_: "2 days ago", sort_by: "date", page_size: 10, list-typed fields)

Verified: the exact call in the new block returns 10 clusters from the hosted server at news-mcp.newscatcherapi.com/mcp. mint broken-links passes; llms.txt and sitemap.xml are unchanged (the page is hidden).

🤖 Generated with Claude Code

"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 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
newscatcherinc 🟢 Ready View Preview Oct 5, 2026, 2:17 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@mintlify

mintlify Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
newscatcherinc-docs 🟢 Ready View Preview Oct 5, 2026, 2:17 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — bdb5aa0d Deployed Oct 5, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants