restful
Execute direct REST API calls to Salesforce to interact with data, manage records, and retrieve metadata using specified HTTP methods, paths, and parameters.
Instructions
Makes a direct REST API call to Salesforce
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Data for POST/PATCH requests | |
| method | No | The HTTP method (default: 'GET') | GET |
| params | No | Query parameters for the request | |
| path | Yes | The path of the REST API endpoint (e.g., 'sobjects/Account/describe') |
Implementation Reference
- src/salesforce/server.py:450-467 (handler)Handler logic for the 'restful' tool in the @server.call_tool() dispatcher. Extracts path, method, params, data from arguments, performs validation, executes sf_client.sf.restful() call, and formats the result as JSON text content.
elif name == "restful": path = arguments.get("path") method = arguments.get("method", "GET") params = arguments.get("params") data = arguments.get("data") if not path: raise ValueError("Missing 'path' argument") if not sf_client.sf: raise ValueError("Salesforce connection not established.") results = sf_client.sf.restful(path, method=method, params=params, json=data) return [ types.TextContent( type="text", text=f"RESTful API Call Result (JSON):\n{json.dumps(results, indent=2)}", ) ] - src/salesforce/server.py:281-312 (registration)Registration of the 'restful' MCP tool in the @server.list_tools() function, defining its name, description, and JSON input schema for validation.
types.Tool( name="restful", description="Makes a direct REST API call to Salesforce", inputSchema={ "type": "object", "properties": { "path": { "type": "string", "description": "The path of the REST API endpoint (e.g., 'sobjects/Account/describe')", }, "method": { "type": "string", "description": "The HTTP method (default: 'GET')", "enum": ["GET", "POST", "PATCH", "DELETE"], "default": "GET", }, "params": { "type": "object", "description": "Query parameters for the request", "properties": {}, "additionalProperties": True, }, "data": { "type": "object", "description": "Data for POST/PATCH requests", "properties": {}, "additionalProperties": True, }, }, "required": ["path"], }, ),