How to Connect AI Tools to Mantle MCP Servers Using OAuth

Get started

Connect your AI tools to Mantle's MCP servers securely using OAuth. Just add the configuration below and authorize when prompted.

Quick setup

Getting started with Mantle MCPs takes just a few minutes:

1. Configure your AI tool

Add the Mantle MCP servers to your AI tool's configuration. Here's an example for Cursor IDE or Claude Desktop:

{
  "mcpServers": {
    "mantle-core": {
      "url": "https://mcp.heymantle.com/core"
    },
    "mantle-growth": {
      "url": "https://mcp.heymantle.com/growth"
    },
    "mantle-docs-management": {
      "url": "https://mcp.heymantle.com/docs_management"
    }
  }
}

You don't need to add all three—just include the MCPs relevant to your workflow. See MCPs Overview for what each one covers.

Docs MCP (no auth required) — Each docs repository also has a read-only MCP endpoint at https://your-handle.mantledocs.com/mcp (or https://docs.yourapp.com/mcp with a custom domain). This doesn't require OAuth—just add it to your config and it works immediately. See MCPs Overview for details.

2. Authorize your AI tool

When you first try to use the MCPs, your AI tool will authenticate and ask you to select your organization in Mantle. Once you approve, you're all set!

Write permissions are powerful — While write scopes like write:customers and write:docs enable powerful automation, they should be handled carefully as they can directly affect your business.

Available scopes

When you authorize the MCP connection, you grant access to specific scopes:

Read scopes:

read:apps - View app information
read:customers - View customer data
read:subscriptions - View subscription details
read:plans - View plan information
read:metrics - Access analytics and reports
read:transactions - View transaction history
read:reviews - View app reviews
read:flows - View flows
read:affiliates - View affiliate data
read:docs - View documentation pages and structure

Write scopes:

write:customers - Create/update customer information
write:plans - Manage app plans
write:flows - Create/edit flows
write:docs - Create, update, publish, and manage documentation

Security

User-delegated access - Tokens are tied to your Mantle account, not a shared API key
Revocable at any time - Disconnect the MCP in your AI tool settings
Organization-isolated - Your tokens only access your organization's data
Audit logging - All MCP requests are logged for security and debugging