news-api-mcp AGENTS.md

AGENTS.md

Guidance for AI agents working in this repository.

What this repository is

Documentation and client configs for the hosted APITube News MCP server at https://mcp.apitube.io/. The server itself is not here — it runs as a service, and this repository is what a user or an agent reads to connect to it.

README.md                  what the server is, how to connect, what the tools accept
llms-install.md            install instructions written for an agent doing the setup
server.json                the entry published to registry.modelcontextprotocol.io
configs/                   ready config files, one per MCP client
assets/logo.svg            APITube logo at the top of the README (light theme)
assets/logo-dark.svg       white version for prefers-color-scheme: dark
assets/logo-400.png        400×400 icon for directories that ask for one

There is no build step, no dependencies and no server code.

Rules for editing

1. Verify against the running server before writing anything down. initialize, tools/list and prompts/list answer without a key:

   curl -s -X POST https://mcp.apitube.io/ -H 'Content-Type: application/json' \
     -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
   

   Tool arguments, defaults and limits come from the live tools/list schema, not from memory.

2. Do not trust the docs over the server. Where https://docs.apitube.io and the running service disagree, the service wins and this repository records the real behaviour.

3. Never put a real API key in an example. Use YOUR_API_KEY in configs and read APITUBE_API_KEY from the environment in scripts.

4. Every config here must be pasteable as-is. Test a changed config in the client it targets before committing it — a key in the wrong header fails as 401 ER0201 with no other hint.

5. server.json mirrors the published registry entry (io.apitube/news). Changing it here does not publish anything — the entry is published separately with mcp-publisher, and a change to tools or transport means bumping version in both places.