API Reference
Dynamic Tool Tools API
Complete reference for managing custom MCP tools.
create_dynamic_tool
Create a new custom MCP tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Unique tool name |
| description | string | Yes | Tool description |
| input_schema | object | Yes | JSON Schema for inputs |
| tool_type | string | Yes | http_proxy, transform, chain, skill_backed |
| http_config | object | No | Config for http_proxy type |
| transform_config | object | No | Config for transform type |
| chain_config | object | No | Config for chain type |
| skill_config | object | No | Config for skill_backed type |
| activate | boolean | No | Activate immediately |
update_dynamic_tool
Update an existing custom tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tool_id | string | Yes | Tool ID |
| name | string | No | New name |
| description | string | No | New description |
| input_schema | object | No | New schema |
| http_config | object | No | Updated HTTP config |
| transform_config | object | No | Updated transform config |
| chain_config | object | No | Updated chain config |
| skill_config | object | No | Updated skill config |
| status | string | No | draft, active, disabled |
delete_dynamic_tool
Delete a custom tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tool_id | string | Yes | Tool ID |
list_dynamic_tools
List all custom tools.
| Parameter | Type | Description |
|---|---|---|
| status | string | draft, active, disabled, all |
| tool_type | string | Filter by type |
get_dynamic_tool
Get details of a custom tool.
| Parameter | Type | Description |
|---|---|---|
| tool_id | string | Tool ID |
| name | string | Tool name |
test_dynamic_tool
Test a custom tool with sample input.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tool_id | string | Yes | Tool ID |
| test_input | object | Yes | Sample input |
create_connection
Create an external connection for API authentication.
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Connection name |
| provider | string | Yes | Service provider |
| auth_type | string | Yes | oauth2, api_key, bearer, basic |
| oauth_config | object | No | OAuth2 configuration |
| api_key_config | object | No | API key configuration |
| basic_auth_config | object | No | Basic auth configuration |
| base_url | string | No | Base URL for requests |
| default_headers | object | No | Headers to include |
list_connections
List all external connections.
| Parameter | Type | Description |
|---|---|---|
| provider | string | Filter by provider |
delete_connection
Delete an external connection.
| Parameter | Type | Required | Description |
|---|---|---|---|
| connection_id | string | Yes | Connection ID |
Code Tool APIs
create_code_tool
Create a JavaScript code tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Tool name |
| description | string | Yes | Description |
| input_schema | object | Yes | JSON Schema |
| code | string | Yes | JavaScript code |
| runtime | string | Yes | javascript or typescript |
| timeout_ms | number | No | Timeout (default 10000) |
| memory_limit_mb | number | No | Memory limit (default 64) |
| allowed_domains | string[] | No | Allowed fetch domains |
| env_vars | object | No | Environment variables |
approve_code_tool
Approve a code tool for activation.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tool_id | string | Yes | Tool ID |
| review_notes | string | No | Approval notes |
reject_code_tool
Reject a code tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tool_id | string | Yes | Tool ID |
| reason | string | Yes | Rejection reason |
list_pending_code_tools
List code tools awaiting approval. No parameters.