Skip to main content

MCP Overview

MCP (Model Context Protocol) is a standard protocol that lets AI chat tools connect to external services. Orki provides two MCP servers so you can interact with the platform directly from your favorite AI assistant.

Available MCP Servers​

Orki Docs MCP​

Ask questions about Orki and get answers from this documentation.

  • URI: https://docs-mcp.orki.ai/sse
  • No authentication required

Orki App MCP​

Manage your Orki account through AI chat — create campaigns, view customers, send templates, and more.

  • URI: https://mcp.orki.ai/sse
  • Requires authentication
note

The Orki App MCP requires authentication. You'll need a service account token (see Service Account Tokens) to connect.

Setup Instructions​

Add the MCP servers to your AI chat tool using the configuration below.

Claude Desktop​

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "orki-docs": {
      "url": "https://docs-mcp.orki.ai/sse"
    },
    "orki-app": {
      "url": "https://mcp.orki.ai/sse"
    }
  }
}

File location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor​

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "orki-docs": {
      "url": "https://docs-mcp.orki.ai/sse"
    },
    "orki-app": {
      "url": "https://mcp.orki.ai/sse"
    }
  }
}

Windsurf​

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "orki-docs": {
      "url": "https://docs-mcp.orki.ai/sse"
    },
    "orki-app": {
      "url": "https://mcp.orki.ai/sse"
    }
  }
}

Claude Code (CLI)​

claude mcp add orki-docs --transport sse https://docs-mcp.orki.ai/sse
claude mcp add orki-app --transport sse https://mcp.orki.ai/sse

Use Cases​

What You Want to DoWhich MCP ServerExample Prompt
Learn about Orki featuresDocs MCP"How do I create a campaign?"
Query your account dataApp MCP"Show me my VIP customers"
Execute actionsApp MCP"Send the Ramadan offer template to all gold-tier customers"
Look up documentationDocs MCP"What event types can I subscribe to for webhooks?"
tip

Start with the Docs MCP to learn about Orki features, then add the App MCP when you're ready to manage your account through AI chat.

Next Steps​