MCP

Agent: invoke a tool on an MCP server

Changed on

Agent: invoke a tool on an MCP server.

Auth: Required (bearer token). Scope: Organization-scoped in authenticated context. Side effects: May mutate server state.

post/api/v1/mcp/internal/tools/call

Request

  • Base URL
    http://:8080
  • URL
    http://:8080/api/v1/mcp/internal/tools/call
  • Auth
    none declared

Headers

Acceptstring

Request body */*

argumentsobject nullable

Tool-specific arguments as key-value pairs

server_idstring uuid required

ID of the MCP server to call the tool on

tool_namestring required

Name of the MCP tool to invoke

Example request

{
  "tool_name": "search"
}

Response

OK

dataunknown
messagestring
statusstring

Changes

    • breaking

      the request property became required

    • breaking

      the request property became required

    • info

      api tag MCP added

    • info

      api tag api/v1/mcp removed

    • info

      api tag internal removed

    • info

      api tag tools removed

    • info

      endpoint added