Documentation

Overview

MCPGRAM is an MCP (Model Context Protocol) platform: a control plane for connecting native apps (GitHub, Slack, Notion, Figma, and more), external MCP servers, and AI coding agents under one workspace model.

• Native connectors - OAuth to popular apps; tools appear in your workspace catalog.
• External MCP - paste any MCP URL; discover tools and complete OAuth when the server requires it.
• Universal Layer - agents call stable meta-tools (search_tools, execute_tool, etc.) instead of raw provider IDs.
• CLI - one install path for Claude Code, Cursor, Codex, VS Code, and other providers.

Quickstart

Goal: signup → connect one app → configure your agent → first successful tool call.

1. Sign up and create a workspace.
2. Open the workspace and connect a native app — start with Slack or GitHub.
3. Choose how your agent will call MCPGRAM (pick one path below).
4. Run a read tool first, then optional writes.

https://mcpgram-mcp-server.vercel.app/mcp

{
  "mcpServers": {
    "mcpgram": {
      "url": "https://mcpgram-mcp-server.vercel.app/mcp"
    }
  }
}

https://mcpgram.vercel.app/api/mcp

Authorization: Bearer <workspace-api-key>

First tool calls

• Slack: slack_list_channels → invite the bot to a channel → slack_send_message with the channel id.
• GitHub: github_list_repos or github_get_repo (read-only) before any write tools.

Common failures

Optional CLI path: install the CLI and run mcpgram login / mcpgram onboard --agent cursor.

Native connectors

Native connectors use provider OAuth. From the dashboard, open Apps (or a workspace Manage page), choose a provider, and complete consent. Credentials are stored encrypted and can be enabled or disabled per workspace without fully disconnecting.

• Click Connect on the app card.
• Approve scopes on the provider.
• Return to MCPGRAM; tools are provisioned into the catalog.
• Use Refresh if the provider adds tools later.

External MCP servers

Add any Streamable HTTP / SSE MCP endpoint from the Apps page or workspace MCP panel.

• No auth - Discover tools immediately if the server is public.
• OAuth - MCPGRAM discovers authorization metadata and attempts dynamic client registration (DCR).
• Redirect: https://mcpgram.vercel.app/api/oauth/mcp/callback

CLI

Official package: @mcpgram/cli

curl -fsSL https://mcpgram.vercel.app/install | bash
# or: npm install -g @mcpgram/cli

mcpgram login
mcpgram onboard --agent cursor
mcpgram sync
mcpgram doctor

Requires Node.js 18+. Linux, macOS, Windows, and WSL.

AI agents

Supported targets include Claude Code, Cursor, Codex, VS Code, Gemini CLI, Windsurf, Cline, Aider, Goose, OpenCode, and related providers. The CLI writes the correct MCP config for each.

In-app guides: Dashboard - Guides - Agents (login required).

Universal Layer

Agents primarily see meta-tools, not every raw connector tool:

• search_tools - find tools across sources
• get_tool - schema / details
• execute_tool - run by stable id

OAuth and integrations

• Site: https://mcpgram.vercel.app
• Docs: https://mcpgram.vercel.app/docs
• Callback: https://mcpgram.vercel.app/api/oauth/<provider>/callback

Security

• OAuth tokens and MCP secrets encrypted at rest.
• Prefer least-privilege scopes.
• Revoke from the provider or disconnect in MCPGRAM.
• See Privacy and Terms.

Support

Contact or email aaryanverma4326@gmail.com.