POpoll-the-people
Agent Actions

Create a custom action (MCP).

Changed on
post/api/v1/projects/{projectId}/actions/custom

Request

Path parameters

projectIdinteger required
Example:1

The unique agent identifier.

Request body

namestring

Action name.

descriptionstring nullable

Action description.

action_type'mcp_connector'

Custom action type. Currently only MCP connector is supported.

Example request

{
  "name": "My MCP Action",
  "description": "CRM lookup",
  "action_type": "mcp_connector",
  "settings": {
    "mcp_url": "https://example.mcp.server",
    "require_tool_confirmation": true
  }
}

Response

Custom action created.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "action": {
      "project_id": 1,
      "tool_key": "custom_mcp_connector_8f3a1b2c",
      "name": "My MCP Action",
      "description": "CRM lookup",
      "action_type": "mcp_connector"
    }
  }
}

Changes