[raj-dubey1]

Description

The CometChat MCP server (https://mcp.cometchat.com/mcp, live in production) now has account tools next to the docs tools. The docs still described it as a read-only, docs-only server with four tools. This PR updates the pages that describe it.

mcp-server.mdx (MCP Integration)

• One endpoint, two kinds of tools: the docs tools need no sign-in; the account tools ask you to sign in to CometChat (OAuth) the first time one is used. Without signing in, the agent asks for credentials instead.
• Setup per client, now including Claude Code (claude mcp add + /mcp → Authenticate) and the Agent Skills installer. The Windsurf and VS Code configs now use HTTP instead of SSE.
• Signing in: full or read-only access, which AI tools get full access (Claude's connector, local tools, ChatGPT, Grok, Antigravity, Mistral Le Chat, Perplexity), unverified apps, where the sign-in is stored and how long it lasts.
• Confirmations and approvals: reads and new items run; changes to existing data need an OK in the chat; high-risk changes (API keys, login tokens, webhooks, app settings, the OpenAI key, team invites, every delete) need a one-time approval code from the browser. The tools can't delete apps, change billing, transfer ownership or ban users.
• All 50 account tools, grouped by area, with the confirmation each needs.
• Bundles: 11 now (the Angular quickstart was missing).
• Disconnecting and Privacy sections.

Other pages

• index.mdx: the "Docs MCP" card is now "CometChat MCP".
• lovable.mdx: says No authentication gives Lovable the docs tools only; the account tools need a sign-in.
• fundamentals/network-allowlist.mdx: the mcp.cometchat.com row covers the account tools.

Checks

• The tool list and each tool's confirmation level were compared with the live server's tools/list: 50 of 50 match.
• mint broken-links: no broken links in the changed files. Five React UI Kit pages fail to parse on main already (integration-*.mdx, overview.mdx); they aren't touched here.
• The disconnect help page linked from the page returns 200.

Not in this PR

• agent-skills.mdx and cli.mdx describe skills 5.1 (the cometchat-docs server and @cometchat/skills-cli), which is what users install today. They'll change when skills 5.2.0 is released.

Related Issue(s)

ENG-40282

Type of Change

• Documentation correction/update
• New documentation
• Improvement to existing documentation
• Typo fix
• Other (please specify)

Checklist

• I have read the CONTRIBUTING document
• My branch name follows the naming convention
• My changes follow the documentation style guide
• I have checked for spelling and grammar errors
• All links in my changes are valid and working
• My changes are accurately described in this pull request

🤖 Generated with Claude Code

https://claude.ai/code/session_01XbguTrrMTEBCGpxQkoKHhV

[mintlify]

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

Project	Status	Preview	Updated
cometchat	🟢 Ready	View Preview	Nov 13, 2026, 2:36 PM

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

[jitvarpatil]

🤖 Review Buddy (review-docs-pr)

Recommendation: approve. Automated review; the final decision stays with a maintainer.

TL;DR: Nothing in this PR breaks the docs. It only changes 4 existing pages: no moves, renames, deletions or docs.json edits, so it needs no redirects and the build is safe. I checked the tool reference against the live server. tools/list on https://mcp.cometchat.com/mcp returns 54 tools (4 docs + 50 account). They match the page's tables exactly, and every tool marked — in Asks first is annotated readOnlyHint: true on the server. I found 3 small wording issues (P2), none blocking.

P0: none

P1: none

P2: nits

1. mcp-server.mdx:118-121, mcp-server.mdx:315: the Agent Skills installer uses a different server name. npx @cometchat/skills add (5.1) registers this server as cometchat-docs (agent-skills.mdx:68-69, :310). It only adds it for Claude Code, Cursor, Gemini and Codex ("Other agents get no MCP entry"). So someone who installed through the skills looks for cometchat under Disconnecting ("/mcp, pick cometchat") and doesn't find it. Suggestion: say "adds it as cometchat-docs for Claude Code, Cursor, Gemini and Codex", or add "(cometchat-docs if you installed it with the Agent Skills)" in Disconnecting and Claude Code. This can wait for skills 5.2 if that release renames the entry.
2. lovable.mdx:4,8,10,17,49: two names for the server on one page. Line 38 now says "The CometChat MCP's docs tools", but the description, intro, the ## Connect the Docs MCP heading and line 49 still say "CometChat Docs MCP". The index card was renamed to "CometChat MCP". Suggestion: rename consistently, or say once that the Lovable setup uses only the docs tools of the CometChat MCP. Renaming the heading changes its #connect-the-docs-mcp anchor, so check for links to it first.
3. mcp-server.mdx:149: "Known tools are ones running on your machine" is unclear. A reader can't tell how the server decides that a tool is running locally. If it means OAuth clients that redirect to localhost/127.0.0.1, say that, e.g. "local AI tools such as Claude Code, Cursor or VS Code, which sign in through a localhost address".

Passed / checked

• Redirects: 0 removed or renamed files, so no URLs are lost (4 modified files only).
• Navigation: docs.json isn't touched. mcp-server and lovable are still in the navigation (docs.json:102,104).
• In-content links: 0 broken links in the 4 changed files. The script found 21 broken link targets elsewhere in the repo. They are pre-existing and none are in this PR's files.
• Live server check: all 54 tool names match the page. The resource cometchat://skills/overview still exists. The server's own instructions list 11 bundles, including Angular, matching "Eleven implementation bundles". The account tools' code is in the public repo cometchat/docs-mcp, so the "open-source" claim holds.
• Asks-first consistency: every delete_* tool is marked browser, matching "every delete". The create-API-key, login-token and webhook tools, app settings, the OpenAI key and the team invite are marked browser. Create app, users, group, role and keyword list run straight away, as the confirmations table says.
• External link: https://mcp.cometchat.com/oauth/cometchat/disconnect returns 200.
• Fix in this PR: the Source link text cometchat/cometchat-mcp didn't match the link target docs-mcp. This PR corrects it, and the file's missing final newline is fixed.
• Not checked: whether each change tool asks in the chat or in the browser. The server's tool annotations don't record this. I relied on the author's check against the server.
• Skipped: a Mintlify build and rendered preview. Mintlify's preview deployment for this PR is 🟢 Ready.

[jitvarpatil]

✅ Approved via Review Buddy after an automated review (P0: 0 · P1: 0 · P2: 3).

Findings: #608 (review)