Skip to main content
POST
Execute MCP Tool
Executes a tool directly on an MCP server configured by the authenticated user.

Usage

Request Body

Response

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