Home/MCP server/Developer reference
ViralDM MCP: developer reference
Everything a client needs to talk to ViralDM’s MCP server. The full tool list with parameters is on /docs/mcp.
https://mcp.viraldm.app/mcpEvery plan · read-only on Free, read and write from Starter · Full tool list · Last updated 14 October 2026
Reference
Endpoint, auth and limits
| Endpoint | https://mcp.viraldm.app/mcp — POST (JSON-RPC) and GET (stream), Streamable HTTP |
|---|---|
| Health | https://mcp.viraldm.app/health — status and the number of tools |
| Resource metadata | https://mcp.viraldm.app/.well-known/oauth-protected-resource (RFC 9728). A 401 carries WWW-Authenticate: Bearer resource_metadata="…" |
| Authorization server | https://viraldm.app/.well-known/oauth-authorization-server — authorize, token, register (RFC 7591), revoke, introspect |
| Grant | authorization_code with PKCE (S256, required for public clients) and refresh_token |
| Scopes | mcp:read, mcp:write. Self-registered clients can hold only these two |
| Tokens | Access token 1 hour; refresh token 30 days, rotated on use |
| API keys | A personal key from viraldm.app → Dashboard → API keys, sent as Authorization: Bearer <key>, for clients without OAuth |
| Rate limit | 60 requests a minute per token |
| Plan | MCP works on every plan: read-only on Free (a write gets 403 with an upgrade URL), read and write from Starter. Calling the API directly with a key starts on Growth |
| Redirect URIs | Any https URI, http on localhost/127.0.0.1, and a short list of native-app schemes. The consent screen shows the host access goes to |
Every tool and its parameters: /docs/mcp. Server page: mcp.viraldm.app.
All guides
ViralDM MCP server pages
- Overview: the ViralDM MCP server
- Connect ViralDM to Claude
- Connect ViralDM to ChatGPT
- Connect ViralDM to Claude Code
- Connect ViralDM to OpenAI Codex
- Connect ViralDM to Cursor
- Connect ViralDM to Gemini, Gemini CLI and Antigravity
- Connect ViralDM to Windsurf (Devin Desktop)
- Connect ViralDM to VS Code (GitHub Copilot)
- Connect ViralDM to Perplexity
- Connect ViralDM to Notion
- Connect ViralDM to Grok
- Connect ViralDM to Hermes Agent
- Connect ViralDM to n8n
- Connect ViralDM to Zed
- Connect ViralDM to Cline
- Connect ViralDM to LM Studio
- Connect ViralDM to Microsoft Copilot Studio
- Automate Instagram DMs with an AI assistant
- Sell over UPI with an AI assistant
- Ask your AI what your DMs are saying
- Developer reference: endpoint, OAuth, scopes, limits
- Frequently asked questions
- ViralDM MCP vs SuperProfile MCP
Last updated 14 October 2026.
Connect your assistant to ViralDM
MCP works on every plan — read-only on Free, read and write from Starter. New here? Your first month of Starter is free, no card.
