MCP Salesforce Connector

Instructions

Implementation Reference

• src/salesforce/server.py:227-252 (registration)

  Registration of the 'tooling_execute' tool including its name, description, and JSON schema for input validation.

  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"],
      },
  ),

• src/salesforce/server.py:413-429 (handler)

  The execution handler for the 'tooling_execute' tool. Parses arguments, validates inputs, calls the Salesforce Tooling API via simple-salesforce library, and returns the JSON-formatted result.

  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)}",
          )
      ]