MCP Salesforce Connector

Instructions

Implementation Reference

• src/salesforce/server.py:354-368 (handler)

  The execution logic for the 'get_record' tool. Retrieves a Salesforce record by object name and ID using the simple-salesforce library and returns it as JSON-formatted text content.

  elif name == "get_record":
      object_name = arguments.get("object_name")
      record_id = arguments.get("record_id")
      if not object_name or not record_id:
          raise ValueError("Missing 'object_name' or 'record_id' argument")
      if not sf_client.sf:
          raise ValueError("Salesforce connection not established.")
      sf_object = getattr(sf_client.sf, object_name)
      results = sf_object.get(record_id)
      return [
          types.TextContent(
              type="text",
              text=f"{object_name} Record (JSON):\n{json.dumps(results, indent=2)}",
          )
      ]

• src/salesforce/server.py:149-166 (registration)

  Registers the 'get_record' tool in the list_tools handler, defining its name, description, and input schema requiring 'object_name' and 'record_id'.

  types.Tool(
      name="get_record",
      description="Retrieves a specific record by ID",
      inputSchema={
          "type": "object",
          "properties": {
              "object_name": {
                  "type": "string",
                  "description": "The name of the Salesforce object (e.g., 'Account', 'Contact')",
              },
              "record_id": {
                  "type": "string",
                  "description": "The ID of the record to retrieve",
              },
          },
          "required": ["object_name", "record_id"],
      },
  ),

• src/salesforce/server.py:152-164 (schema)

  JSON Schema for 'get_record' tool input validation, specifying required properties 'object_name' and 'record_id'.

  inputSchema={
      "type": "object",
      "properties": {
          "object_name": {
              "type": "string",
              "description": "The name of the Salesforce object (e.g., 'Account', 'Contact')",
          },
          "record_id": {
              "type": "string",
              "description": "The ID of the record to retrieve",
          },
      },
      "required": ["object_name", "record_id"],