Open Platform Contact EspoDev

MCP access

AI assistants connect through the Model Context Protocol

The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external systems. Open Platform exposes an MCP endpoint so that approved assistants can read and update issues, pull requests and deployments on behalf of a signed-in user, with that user's permissions.

Request handling

How each call is processed

MCP request handling: clients, authentication, rate limit, authorization and tool execution, and what each tool can reach
Open the diagram at full size
  1. Authentication

    OAuth 2.1 with PKCE, or a personal access token. The user selects read-only or read-write access. On the forge, OAuth grants never include administrator scope.

  2. Rate limiting

    Calls are rate limited per user before any tool runs.

  3. Authorization

    The user's role is checked on every call, and calls the role does not allow are denied. Administrator tools are hidden from tokens without administrator scope.

  4. Execution

    Each tool calls the same server code as the corresponding web page, with the same permission checks.

Controls

Additional controls

Audit logging

The platform logs every MCP tool call, successful or not, with the user, the tool, the result and the duration.

Revocation

An administrator can block a user's MCP access immediately.

Untrusted input

In the forge's built-in assistant, content from outside users is marked as untrusted. A write the user did not request waits for the user's confirmation.

No model access

The MCP endpoint provides tools only and calls no AI model. The connected assistant uses its own model, under your organization's choice of provider.

Clients

Supported clients

ClientAuthenticationAccess
A user's AI assistantAn assistant that supports remote MCP with OAuthThe user's permissions, read-only or read-write as selected
Agents running a taskA token issued for that taskOn the platform: one repository (for a planning agent, one organization), with no access to CI workflow files. On the forge: valid for the duration of the run.
Outside contributors (forge)NonePublic tools only: report a problem, propose a change, search

The platform and the forge each expose an MCP endpoint. The forge's endpoint provides about 200 tools and lists 13 by default, with a search tool for the rest.