Skip to main content
POST
/
v1
/
mcp
/
tool
/
execute
Execute an MCP tool
curl --request POST \
  --url http://localhost:8080/v1/mcp/tool/execute \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "function",
  "id": "<string>",
  "function": {
    "name": "<string>",
    "arguments": "<string>"
  }
}'
{
  "role": "user",
  "content": "Hello, how are you?",
  "tool_call_id": "<string>",
  "tool_calls": [
    {
      "id": "tool_123",
      "type": "function",
      "function": {
        "name": "get_weather",
        "arguments": "{\"location\": \"San Francisco, CA\"}"
      }
    }
  ],
  "refusal": "<string>",
  "annotations": [
    {
      "type": "<string>",
      "url_citation": {
        "start_index": 123,
        "end_index": 123,
        "title": "<string>",
        "url": "<string>",
        "sources": "<any>",
        "type": "<string>"
      }
    }
  ],
  "thought": "<string>"
}

Body

application/json
​
function
object
required
​
type
string
Example:
​
id
string

Response

​
role
enum<string>
required
Available options:
user,
assistant,
system,
tool
Example:
​
content
Example:
​
tool_call_id
string
​
tool_calls
object[]
​
refusal
string
​
annotations
object[]
​
thought
string