Skip to main content
POST
/
mcp-tools
/
execute
Execute MCP Tool
curl --request POST \
  --url https://app.splox.io/api/v1/mcp-tools/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mcp_server_id": "0199e001-a23b-7c8d-1234-567890abcdef",
  "tool_slug": "search_documents",
  "args": {
    "query": "latest release notes"
  }
}
'
{
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Found 3 matching documents"
      }
    ],
    "isError": false
  },
  "is_error": false
}
Executes a tool directly on an MCP server configured by the authenticated user.

​
Usage

curl -X POST https://app.splox.io/api/v1/mcp-tools/execute \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mcp_server_id": "0199e001-a23b-7c8d-1234-567890abcdef",
    "tool_slug": "search_documents",
    "args": {
      "query": "latest release notes"
    }
  }'

​
Request Body

FieldTypeRequiredDescription
mcp_server_idstring (uuid)YesID of the user MCP server to execute against. Must belong to the authenticated user.
tool_slugstringYesTool name/slug to execute on that MCP server.
argsobjectNoTool input arguments. Defaults to an empty object.

​
Response

{
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Found 3 matching documents"
      }
    ],
    "isError": false
  },
  "is_error": false
}

​
Notes

  • This endpoint executes synchronously and returns the tool result in the HTTP response.
  • The response result object is passed through from the MCP server and may include fields like content, structuredContent, and isError.
  • Rate limit: 30 requests per minute per authenticated user.

Authorizations

​
Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Body

application/json
​
mcp_server_id
string<uuid>
required

ID of the user MCP server to execute against

​
tool_slug
string
required

Tool name/slug to execute

​
args
object

Tool input arguments

Response

Tool executed successfully

​
result
object

Raw MCP CallTool result payload

​
is_error
boolean

Convenience flag mirroring result.isError