MCP Salesforce Connector

Instructions

Implementation Reference

• src/salesforce/server.py:415-431 (handler)

  Handler for the 'tooling_execute' tool within the @server.call_tool() function. Extracts action, method, and data arguments, validates them, and invokes the Salesforce Tooling API via sf_client.sf.toolingexecute(). Returns the result as formatted JSON text content.

  elif name == "tooling_execute":
      action = arguments.get("action")
      method = arguments.get("method", "GET")
      data = arguments.get("data")
  
      if not action:
          raise ValueError("Missing 'action' argument")
      if not sf_client.sf:
          raise ValueError("Salesforce connection not established.")
  
      results = sf_client.sf.toolingexecute(action, method=method, data=data)
      return [
          types.TextContent(
              type="text",
              text=f"Tooling Execute Result (JSON):\n{json.dumps(results, indent=2)}",
          )
      ]

• src/salesforce/server.py:229-254 (registration)

  Registration of the 'tooling_execute' tool in the @server.list_tools() function, including its description and JSON schema for input validation (action required, optional method and data).

  types.Tool(
      name="tooling_execute",
      description="Executes a Tooling API request",
      inputSchema={
          "type": "object",
          "properties": {
              "action": {
                  "type": "string",
                  "description": "The Tooling API endpoint to call (e.g., 'sobjects/ApexClass')",
              },
              "method": {
                  "type": "string",
                  "description": "The HTTP method (default: 'GET')",
                  "enum": ["GET", "POST", "PATCH", "DELETE"],
                  "default": "GET",
              },
              "data": {
                  "type": "object",
                  "description": "Data for POST/PATCH requests",
                  "properties": {},
                  "additionalProperties": True,
              },
          },
          "required": ["action"],
      },
  ),