MCP Salesforce Connector

Instructions

Implementation Reference

• src/salesforce/server.py:352-366 (handler)

  Handler implementation for the 'get_record' tool: extracts object_name and record_id from arguments, retrieves the Salesforce object, fetches the record using simple-salesforce library, and returns the record data as JSON.

  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:147-164 (registration)

  Tool registration for 'get_record' including name, description, and input schema definition within the @server.list_tools() handler.

  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:150-163 (schema)

  JSON schema for 'get_record' tool input: requires object_name and record_id as strings.

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