Indian Opinion

Indian news briefs synthesised from 50+ outlets, with corroboration counts and per-outlet framing.

Hosted MCP Server

npx add-mcp 'https://indianopinion.org/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Indian Opinion MCP server

The Indian Opinion MCP server gives AI agents and assistants Indian news briefs synthesised from many outlets, with corroboration counts and how each outlet framed the story, plus the daily digest, topic alerts and Breaking News for agent accounts.

EndpointFor
https://indianopinion.org/mcpAny MCP client over Streamable HTTP. Public tools need no sign-in; account tools take Authorization: Bearer ioa_...
https://indianopinion.org/mcp/oauthClients that sign in with OAuth 2.1 (claude.ai, ChatGPT and others): the same server, with OAuth required

This repository is the source of that server: a Cloudflare Worker that is a thin adapter over the Indian Opinion REST agent API (https://indianopinion.org/wp-json/io/v1). Every tool is one REST call made with the caller's own credentials; there is no business logic or data store here beyond the OAuth state. It also holds the OpenAPI 3.1 document, the agents.txt and the MCP server card the Worker serves, and setup guides for each client.

The command-line client and stdio bridge is IndianOpinion/cli. Until its first npm publish, install it from GitHub: npm i -g github:IndianOpinion/cli (or the site copy, npm i -g https://indianopinion.org/agents/cli/latest.tgz).

Connect

ClientGuideMethod
claude.ai, Claude Desktop and mobiledocs/claude-ai.mdCustom connector, OAuth
ChatGPTdocs/chatgpt.mdCustom MCP server (developer mode), OAuth
Claude Codedocs/claude-code.mdclaude mcp add --transport http
Cursordocs/cursor.mdmcp.json with url
Grokdocs/grok.mdCustom connector in the app; remote MCP tool in the xAI API
OpenClawdocs/openclaw.mdopenclaw mcp add
Hermes Agentdocs/hermes.mdmcp_servers in config.yaml
Meta Musedocs/meta-muse.mdNot verified
Instinctdocs/instinct.mdNot verified
Any other MCP clientdocs/generic-mcp.mdStreamable HTTP URL
Agents without MCPdocs/openapi.mdOpenAPI 3.1 over REST

Tools

Fifteen tools. Lists default to 10 items and cap at 25. Every tool sets a title, all four annotation hints (read-only, destructive, idempotent, open-world) and an outputSchema that describes its structuredContent. The server is stateless, so it advertises listChanged: false.

ToolAuthWhat it does
search_briefspublicSearch published briefs by text, category and date, with cursor paging
get_briefpublicOne brief by id or article URL: summary, sources, corroboration and framing
signup_startpublicEmail a 6-digit sign-in code to an address
signup_verifypublicExchange the email and code for an account token (ioa_...)
get_accountaccountThe signed-in account: masked email, preferences, topics followed, recent Breaking News sends
update_preferencesaccountChange digest format and hour, and Breaking News settings
list_topicsaccountTopics the account follows
follow_topicaccountFollow a topic, with an alert tier
unfollow_topicaccountStop following a topic
get_digestaccountThe latest daily digest, or the one for a date
list_breakingaccountRecent Breaking News candidates and their scores
get_breaking_eventaccountOne Breaking News event in full
unsubscribeaccountStop the digest, Breaking News, topic alerts or all emails
create_browser_linkaccountA one-time, 10-minute link that signs a browser in to the account page
close_accountaccountClose the account: tokens revoked, every email stopped, sign-in disabled (deactivation, not deletion)

Prompts: morning_briefing, explain_framing_gap, watch_topic, tune_breaking, brief_my_human. Resources: indianopinion://about, indianopinion://brief/{id}, indianopinion://digest/{date}.

The OpenAPI operationId of each REST operation equals the MCP tool name.

Public tools and account tools

  • No sign-in. search_briefs, get_brief, signup_start and signup_verify work on https://indianopinion.org/mcp with no credentials.
  • Bearer token. For account tools, sign up with signup_start and signup_verify (or indianopinion login in the CLI) and send the returned token as Authorization: Bearer ioa_.... Clients that can set a header use this on /mcp.
  • OAuth 2.1. Clients that only accept OAuth or no auth (claude.ai, ChatGPT) use https://indianopinion.org/mcp/oauth. A request without a token gets 401 with WWW-Authenticate: Bearer resource_metadata="https://indianopinion.org/.well-known/oauth-protected-resource/mcp/oauth". The server supports dynamic client registration (RFC 7591), the authorization code flow with PKCE S256, rotating refresh tokens and revocation (RFC 7009). Sign-in is the same email code; the connector then appears as a token labelled oauth <client name> on the account, where it can be revoked.

Verifying a new email address switches on the daily digest and Breaking News (at most 5 a day under the default rule); unsubscribe with all stops both. close_account closes the account (with confirm: true): every token is revoked, every email stops and the address can no longer sign in. It is deactivation, not deletion: the account record is kept, deactivated, under the retention terms of https://indianopinion.org/privacy-policy/, and erasure or reopening is by email to hello@indianopinion.org. Tokens are never logged; each tool call logs only the tool name, the public token id, the outcome and the latency.

resources/read failures are JSON-RPC errors: a malformed id or date, or a missing brief or digest, is "resource not found" (-32602, as the 2026-07-28 spec requires); a missing token on indianopinion://digest/{date} is -32001.

Rate limits

ScopeLimit
Requests to /mcp and /mcp/oauth, per IP120 a minute
search_briefs, per IP20 a minute
Account tool calls, per token60 a minute
/oauth/authorize and /oauth/register, per IP30 a minute
/oauth/token and /oauth/revoke, per IP60 a minute
Sign-in codes (set by the API)3 an hour per address, 5 an hour per IP
Request body16 KB (larger is 413)

A limited call returns a tool error with retry_after in seconds. The REST API's own limits are authoritative; the Worker's limits sit in front of them.

Endpoints the Worker serves

PathWhat
/mcpMCP over Streamable HTTP, stateless; the 2026-07-28 revision and the 2025 initialize handshake. GET is 405. 2026-07-28 has no initialize: a client speaks it with the MCP-Protocol-Version: 2026-07-28 and Mcp-Method headers and the _meta envelope on each request. An initialize request is the 2025 handshake, so it negotiates the newest 2025 revision (2025-11-25) even when it offers 2026-07-28
/mcp/oauthThe same server with OAuth required
/.well-known/mcp/server-card.json (also /.well-known/mcp-server-card, /.well-known/mcp.json)MCP server card (draft, SEP-2127)
/agents.txtagents.txt (community draft)
/agents/openapi.jsonOpenAPI 3.1 of the REST API
/agents/cli/, /agents/skill/SKILL.mdCLI downloads and the Agent Skills file
/.well-known/oauth-protected-resource[/mcp/oauth]RFC 9728 protected resource metadata
/.well-known/oauth-authorization-serverRFC 8414 authorization server metadata
/oauth/register, /oauth/authorize, /oauth/token, /oauth/revokeOAuth 2.1 authorization server

Develop

Node 20 or newer (engines in package.json). wrangler is a pinned devDependency, so npm run dev and npm run check need nothing else.

npm ci
npm test                              # Worker module in Node against a local REST stub; no network

To serve the CLI files under /agents/cli/ as well, clone IndianOpinion/cli next to this checkout as ../cli (or set IO_CLI_DIR) and run npm run build:cli; the tests then also check those files.

To run the Worker on your own Cloudflare account, copy wrangler.example.toml to wrangler.toml, fill in your account id and KV namespace id, and use npm run dev. discovery/ holds the agents.txt and server card exactly as src/discovery.js renders them (npm run discovery rewrites them); the test suite fails if they drift.

FileRole
src/index.jsRouting, guards, rate limits, MCP handler
src/tools.js, src/prompts.js, src/resources.jsMCP tools, prompts and resources
src/client.jsREST client
src/auth.jsThe only reader of credentials (bearer and OAuth)
src/oauth.jsOAuth 2.1 authorization server
src/discovery.jsServer card, agents.txt, CLI index
src/render.jsText rendering of briefs and digests
test/Node test suites and the REST stub
CHANGELOG.mdOne entry per VERSION

Contributing and security

See CONTRIBUTING.md and SECURITY.md. Report vulnerabilities to hello@indianopinion.org, not in public issues.

Licence

MIT. Indian Opinion content returned by the API is not covered by this licence; see https://indianopinion.org/agents/ for its terms of use.