mcp_server_installations

post/api/projects/{project_id}/mcp_server_installations/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/mcp_server_installations/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

idstring uuid required
template_idstring uuid nullable required
namestring required
icon_keystring required

Deprecated: use icon_domain instead. Lowercase key from the linked template for clients that still render bundled icon assets. Empty if custom install (no template).

icon_domainstring required

Brand domain from the linked template, rendered via the logo.dev icon proxy. Empty if custom install (no template).

display_namestring
urlstring uri
descriptionstring required

Installation description, falling back to the linked template description.

auth_type'api_key' | 'oauth'
  • api_key - API Key
  • oauth - OAuth
is_enabledboolean
scope'personal' | 'shared' required
  • personal - Personal
  • shared - Shared
is_ownerboolean required

True when the requesting user owns this installation. Lets clients gate owner-only controls instead of surfacing 403s.

needs_reauthboolean required
pending_oauthboolean required
proxy_urlstring required
tool_countinteger required

Number of live (non-removed) tools exposed by this installation.

created_atstring date-time required
updated_atstring date-time nullable required

Response

idstring uuid required
template_idstring uuid nullable required
namestring required
icon_keystring required

Deprecated: use icon_domain instead. Lowercase key from the linked template for clients that still render bundled icon assets. Empty if custom install (no template).

icon_domainstring required

Brand domain from the linked template, rendered via the logo.dev icon proxy. Empty if custom install (no template).

display_namestring
urlstring uri
descriptionstring required

Installation description, falling back to the linked template description.

auth_type'api_key' | 'oauth'
  • api_key - API Key
  • oauth - OAuth
is_enabledboolean
scope'personal' | 'shared' required
  • personal - Personal
  • shared - Shared
is_ownerboolean required

True when the requesting user owns this installation. Lets clients gate owner-only controls instead of surfacing 403s.

needs_reauthboolean required
pending_oauthboolean required
proxy_urlstring required
tool_countinteger required

Number of live (non-removed) tools exposed by this installation.

created_atstring date-time required
updated_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.