Execute MCP tool

POST/v1/mcp/tool/execute

Executes an MCP tool and returns the result.

Query Parameters

format?string

Format of the tool execution request/response.

Default"chat"

Value in"chat" | "responses"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

index?integer

type?string

id?string

function*

call_id?string

Common call ID for tool calls and outputs

name*string

Tool function name (required for execution)

arguments?string

Tool function arguments as JSON string

output?

Tool execution output

action?

Tool action configuration

error?string

Error message if tool execution failed

Response Body

`application/json`

curl -X POST "http://localhost:8080/v1/mcp/tool/execute" \  -H "Content-Type: application/json" \  -d '{    "id": "call_123",    "type": "function",    "function": {      "name": "get_weather",      "arguments": "{\\"location\\": \\"San Francisco\\"}"    }  }'

{
  "name": "get_weather",
  "role": "tool",
  "tool_call_id": "call_123",
  "content": "The weather in San Francisco is 72°F and sunny."
}

{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}

{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}

Query Parameters

Request Body

Response Body

200application/json

400application/json

500application/json

Chat format response

Responses format response

`application/json`

`application/json`

`application/json`