Mcp API Reference

Mcp

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

POST

Create mcp tools

Invoke an MCP tool by name.

This endpoint allows MCP callers to invoke Max AI tools directly without going through the full LangChain conversation flow.

Scopes are resolved dynamically per tool via dangerously_get_required_scopes.

Path parameters

project_id
string
tool_name
string

Example request

POST /api/environments/:project_id/mcp_tools/:tool_name
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/environments/:project_id/mcp_tools/:tool_name/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/environments/{project_id}/mcp_tools/{tool_name}/".format(
        project_id=project_id,
		tool_name="<the tool name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

Mcp

Endpoints

Create mcp tools

Path parameters

Example request

Example response

Status 200 No response body

Community questions