Skip to content
Back to search

mcp

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,…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/indianopinion--mcp/badge.svg)](/listings/indianopinion--mcp)

HTML

<a href="/listings/indianopinion--mcp"><img src="/api/listings/indianopinion--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 163 lines
  1. # Indian Opinion MCP server
  2. The Indian Opinion MCP server gives AI agents and assistants Indian news briefs synthesised from many
  3. outlets, with corroboration counts and how each outlet framed the story, plus the daily digest, topic
  4. alerts and Breaking News for agent accounts.
  5. | Endpoint | For |
  6. |---|---|
  7. | `https://indianopinion.org/mcp` | Any MCP client over Streamable HTTP. Public tools need no sign-in; account tools take `Authorization: Bearer ioa_...` |
  8. | `https://indianopinion.org/mcp/oauth` | Clients that sign in with OAuth 2.1 (claude.ai, ChatGPT and others): the same server, with OAuth required |
  9. This repository is the source of that server: a Cloudflare Worker that is a thin adapter over the
  10. Indian Opinion REST agent API (`https://indianopinion.org/wp-json/io/v1`). Every tool is one REST call
  11. made with the caller's own credentials; there is no business logic or data store here beyond the OAuth
  12. state. It also holds the [OpenAPI 3.1 document](public/agents/openapi.json), the
  13. [agents.txt](discovery/agents.txt) and the [MCP server card](discovery/server-card.json) the Worker
  14. serves, and [setup guides for each client](docs/).
  15. The command-line client and stdio bridge is [IndianOpinion/cli](https://github.com/IndianOpinion/cli).
  16. Until its first npm publish, install it from GitHub: `npm i -g github:IndianOpinion/cli` (or the site
  17. copy, `npm i -g https://indianopinion.org/agents/cli/latest.tgz`).
  18. ## Connect
  19. | Client | Guide | Method |
  20. |---|---|---|
  21. | claude.ai, Claude Desktop and mobile | [docs/claude-ai.md](docs/claude-ai.md) | Custom connector, OAuth |
  22. | ChatGPT | [docs/chatgpt.md](docs/chatgpt.md) | Custom MCP server (developer mode), OAuth |
  23. | Claude Code | [docs/claude-code.md](docs/claude-code.md) | `claude mcp add --transport http` |
  24. | Cursor | [docs/cursor.md](docs/cursor.md) | `mcp.json` with `url` |
  25. | Grok | [docs/grok.md](docs/grok.md) | Custom connector in the app; remote MCP tool in the xAI API |
  26. | OpenClaw | [docs/openclaw.md](docs/openclaw.md) | `openclaw mcp add` |
  27. | Hermes Agent | [docs/hermes.md](docs/hermes.md) | `mcp_servers` in `config.yaml` |
  28. | Meta Muse | [docs/meta-muse.md](docs/meta-muse.md) | Not verified |
  29. | Instinct | [docs/instinct.md](docs/instinct.md) | Not verified |
  30. | Any other MCP client | [docs/generic-mcp.md](docs/generic-mcp.md) | Streamable HTTP URL |
  31. | Agents without MCP | [docs/openapi.md](docs/openapi.md) | OpenAPI 3.1 over REST |
  32. ## Tools
  33. Fifteen tools. Lists default to 10 items and cap at 25. Every tool sets a title, all four
  34. annotation hints (read-only, destructive, idempotent, open-world) and an `outputSchema` that describes
  35. its `structuredContent`. The server is stateless, so it advertises `listChanged: false`.
  36. | Tool | Auth | What it does |
  37. |---|---|---|
  38. | `search_briefs` | public | Search published briefs by text, category and date, with cursor paging |
  39. | `get_brief` | public | One brief by id or article URL: summary, sources, corroboration and framing |
  40. | `signup_start` | public | Email a 6-digit sign-in code to an address |
  41. | `signup_verify` | public | Exchange the email and code for an account token (`ioa_...`) |
  42. | `get_account` | account | The signed-in account: masked email, preferences, topics followed, recent Breaking News sends |
  43. | `update_preferences` | account | Change digest format and hour, and Breaking News settings |
  44. | `list_topics` | account | Topics the account follows |
  45. | `follow_topic` | account | Follow a topic, with an alert tier |
  46. | `unfollow_topic` | account | Stop following a topic |
  47. | `get_digest` | account | The latest daily digest, or the one for a date |
  48. | `list_breaking` | account | Recent Breaking News candidates and their scores |
  49. | `get_breaking_event` | account | One Breaking News event in full |
  50. | `unsubscribe` | account | Stop the digest, Breaking News, topic alerts or all emails |
  51. | `create_browser_link` | account | A one-time, 10-minute link that signs a browser in to the account page |
  52. | `close_account` | account | Close the account: tokens revoked, every email stopped, sign-in disabled (deactivation, not deletion) |
  53. Prompts: `morning_briefing`, `explain_framing_gap`, `watch_topic`, `tune_breaking`, `brief_my_human`.
  54. Resources: `indianopinion://about`, `indianopinion://brief/{id}`, `indianopinion://digest/{date}`.
  55. The OpenAPI `operationId` of each REST operation equals the MCP tool name.
  56. ## Public tools and account tools
  57. - **No sign-in.** `search_briefs`, `get_brief`, `signup_start` and `signup_verify` work on
  58. `https://indianopinion.org/mcp` with no credentials.
  59. - **Bearer token.** For account tools, sign up with `signup_start` and `signup_verify` (or
  60. `indianopinion login` in the CLI) and send the returned token as `Authorization: Bearer ioa_...`.
  61. Clients that can set a header use this on `/mcp`.
  62. - **OAuth 2.1.** Clients that only accept OAuth or no auth (claude.ai, ChatGPT) use
  63. `https://indianopinion.org/mcp/oauth`. A request without a token gets `401` with
  64. `WWW-Authenticate: Bearer resource_metadata="https://indianopinion.org/.well-known/oauth-protected-resource/mcp/oauth"`.
  65. The server supports dynamic client registration (RFC 7591), the authorization code flow with PKCE
  66. `S256`, rotating refresh tokens and revocation (RFC 7009). Sign-in is the same email code; the
  67. connector then appears as a token labelled `oauth <client name>` on the account, where it can be
  68. revoked.
  69. Verifying a new email address switches on the daily digest and Breaking News (at most 5 a day under
  70. the default rule); `unsubscribe` with `all` stops both. `close_account` closes the account (with
  71. `confirm: true`): every token is revoked, every email stops and the address can no longer sign in. It is
  72. deactivation, not deletion: the account record is kept, deactivated, under the retention terms of
  73. https://indianopinion.org/privacy-policy/, and erasure or reopening is by email to
  74. hello@indianopinion.org. Tokens are never logged; each tool call logs only the tool name, the public
  75. token id, the outcome and the latency.
  76. `resources/read` failures are JSON-RPC errors: a malformed id or date, or a missing brief or digest, is
  77. "resource not found" (-32602, as the 2026-07-28 spec requires); a missing token on
  78. `indianopinion://digest/{date}` is -32001.
  79. ## Rate limits
  80. | Scope | Limit |
  81. |---|---|
  82. | Requests to `/mcp` and `/mcp/oauth`, per IP | 120 a minute |
  83. | `search_briefs`, per IP | 20 a minute |
  84. | Account tool calls, per token | 60 a minute |
  85. | `/oauth/authorize` and `/oauth/register`, per IP | 30 a minute |
  86. | `/oauth/token` and `/oauth/revoke`, per IP | 60 a minute |
  87. | Sign-in codes (set by the API) | 3 an hour per address, 5 an hour per IP |
  88. | Request body | 16 KB (larger is `413`) |
  89. A limited call returns a tool error with `retry_after` in seconds. The REST API's own limits are
  90. authoritative; the Worker's limits sit in front of them.
  91. ## Endpoints the Worker serves
  92. | Path | What |
  93. |---|---|
  94. | `/mcp` | MCP 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 |
  95. | `/mcp/oauth` | The same server with OAuth required |
  96. | `/.well-known/mcp/server-card.json` (also `/.well-known/mcp-server-card`, `/.well-known/mcp.json`) | MCP server card (draft, SEP-2127) |
  97. | `/agents.txt` | agents.txt (community draft) |
  98. | `/agents/openapi.json` | OpenAPI 3.1 of the REST API |
  99. | `/agents/cli/`, `/agents/skill/SKILL.md` | CLI downloads and the Agent Skills file |
  100. | `/.well-known/oauth-protected-resource[/mcp/oauth]` | RFC 9728 protected resource metadata |
  101. | `/.well-known/oauth-authorization-server` | RFC 8414 authorization server metadata |
  102. | `/oauth/register`, `/oauth/authorize`, `/oauth/token`, `/oauth/revoke` | OAuth 2.1 authorization server |
  103. ## Develop
  104. Node 20 or newer (`engines` in package.json). `wrangler` is a pinned devDependency, so `npm run dev`
  105. and `npm run check` need nothing else.
  106. ```sh
  107. npm ci
  108. npm test # Worker module in Node against a local REST stub; no network
  109. ```
  110. To serve the CLI files under `/agents/cli/` as well, clone
  111. [IndianOpinion/cli](https://github.com/IndianOpinion/cli) next to this checkout as `../cli` (or set
  112. `IO_CLI_DIR`) and run `npm run build:cli`; the tests then also check those files.
  113. To run the Worker on your own Cloudflare account, copy `wrangler.example.toml` to `wrangler.toml`,
  114. fill in your account id and KV namespace id, and use `npm run dev`. `discovery/` holds the
  115. agents.txt and server card exactly as `src/discovery.js` renders them (`npm run discovery` rewrites
  116. them); the test suite fails if they drift.
  117. | File | Role |
  118. |---|---|
  119. | `src/index.js` | Routing, guards, rate limits, MCP handler |
  120. | `src/tools.js`, `src/prompts.js`, `src/resources.js` | MCP tools, prompts and resources |
  121. | `src/client.js` | REST client |
  122. | `src/auth.js` | The only reader of credentials (bearer and OAuth) |
  123. | `src/oauth.js` | OAuth 2.1 authorization server |
  124. | `src/discovery.js` | Server card, agents.txt, CLI index |
  125. | `src/render.js` | Text rendering of briefs and digests |
  126. | `test/` | Node test suites and the REST stub |
  127. | `CHANGELOG.md` | One entry per `VERSION` |
  128. ## Contributing and security
  129. See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md). Report vulnerabilities to
  130. hello@indianopinion.org, not in public issues.
  131. ## Licence
  132. [MIT](LICENSE). Indian Opinion content returned by the API is not covered by this licence; see
  133. https://indianopinion.org/agents/ for its terms of use.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.