# `pubchem__pubchem_get_summary`

**Get Entity Summary**

Get descriptive summaries for PubChem entities by ID. Supports assays (AID), genes (Gene ID), proteins (UniProt accession), and taxonomy (Tax ID). Up to 10 per call.

- Server: [PubChem](https://gateway.mcpharbor.dev/docs/servers/pubchem) (`dev.mcpharbor.gateway/pubchem`)
- Price per call: $0.0001 (100 micro-USD); only tools/call is charged
- Endpoint: `https://gateway.mcpharbor.dev/mcp` or `https://gateway.mcpharbor.dev/mcp/pubchem`
- Upstream tool: exposed by the provider; called through this gateway as `pubchem__pubchem_get_summary`
- Provider terms: <https://www.ncbi.nlm.nih.gov/home/about/policies/> (verified 2026-09-19)
- Upstream API documentation: <https://pubchem.ncbi.nlm.nih.gov/docs/pug-rest>
- Rate limit: 350 requests per minute
- Attribution required: Attribution to source recommended, not mandatory

## Parameters

- `entityType` (string, required): Entity type. Determines ID format and returned fields. One of: `assay`, `gene`, `protein`, `taxonomy`.
- `identifiers` (array, required): Entity identifiers (1-10). Type depends on entityType: - assay: AID (number), e.g. \[1000\] - gene: Gene ID (number), e.g. \[1956\] - protein: UniProt accession (string), e.g. \["P00533"\] - taxonomy: Ta...

## Example call

Request headers and body:

```http
POST /mcp HTTP/1.1
Host: gateway.mcpharbor.dev
Authorization: Bearer <your gateway API key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: pubchem__pubchem_get_summary
```

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/clientCapabilities": {},
      "io.modelcontextprotocol/clientInfo": {
        "name": "example-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/protocolVersion": "2026-07-28"
    },
    "arguments": {
      "entityType": "assay",
      "identifiers": []
    },
    "name": "pubchem__pubchem_get_summary"
  }
}
```

A successful response:

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "_meta": {
      "dev.mcpharbor.gateway/call": {
        "chargedMicroUsd": 100,
        "id": "<the id of this charge>"
      }
    },
    "content": [
      {
        "text": "<whatever the upstream tool returned>",
        "type": "text"
      }
    ],
    "resultType": "complete"
  }
}
```

This call costs $0.0001 (100 micro-USD). Reading this page and listing the tool cost nothing.
The `dev.mcpharbor.gateway/call` record in the result is the receipt for that charge. Each
POST is metered separately, so sending the same call again buys another one: see
[agent.txt](https://gateway.mcpharbor.dev/agent.txt), section 7, before retrying.

## Attribution

This provider requires the attribution below wherever you use results from its tools.
Reproduce it verbatim:

> Attribution to source recommended, not mandatory

## Tool definition

Exactly as `tools/list` returns it (free):

```json
{
  "_meta": {
    "dev.mcpharbor.gateway/pricing": {
      "currency": "USD",
      "pricePerCallMicroUsd": 100
    }
  },
  "annotations": {
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "description": "Get descriptive summaries for PubChem entities by ID. Supports assays (AID), genes (Gene ID), proteins (UniProt accession), and taxonomy (Tax ID). Up to 10 per call.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "entityType": {
        "description": "Entity type. Determines ID format and returned fields.",
        "enum": [
          "assay",
          "gene",
          "protein",
          "taxonomy"
        ],
        "type": "string"
      },
      "identifiers": {
        "description": "Entity identifiers (1-10). Type depends on entityType:\n- assay: AID (number), e.g. [1000]\n- gene: Gene ID (number), e.g. [1956]\n- protein: UniProt accession (string), e.g. [\"P00533\"]\n- taxonomy: Tax ID (number), e.g. [9606]",
        "items": {
          "anyOf": [
            {
              "description": "String identifier (e.g. UniProt accession).",
              "type": "string"
            },
            {
              "description": "Numeric identifier (e.g. AID, Gene ID, Tax ID).",
              "type": "number"
            }
          ],
          "description": "Entity identifier — string or number depending on entityType."
        },
        "maxItems": 10,
        "minItems": 1,
        "type": "array"
      }
    },
    "required": [
      "entityType",
      "identifiers"
    ],
    "type": "object"
  },
  "name": "pubchem__pubchem_get_summary",
  "outputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "anyOf": [
      {
        "not": {
          "required": [
            "error"
          ]
        },
        "required": [
          "entityType",
          "summaries",
          "requestedCount",
          "foundCount"
        ]
      },
      {
        "required": [
          "error"
        ]
      }
    ],
    "properties": {
      "entityType": {
        "description": "Entity type queried.",
        "type": "string"
      },
      "error": {
        "additionalProperties": {},
        "description": "Present when the call failed. Absent on success.",
        "properties": {
          "code": {
            "description": "JSON-RPC error code for this failure.",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "data": {
            "additionalProperties": {},
            "properties": {
              "reason": {
                "description": "Machine-readable failure mode.",
                "type": "string"
              },
              "recovery": {
                "additionalProperties": {},
                "description": "Actionable next step for the caller.",
                "properties": {
                  "hint": {
                    "type": "string"
                  }
                },
                "required": [
                  "hint"
                ],
                "type": "object"
              },
              "retryable": {
                "description": "Whether retrying may succeed.",
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "message": {
            "description": "Human-readable description of what went wrong.",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object"
      },
      "foundCount": {
        "description": "Identifiers resolved to a summary.",
        "type": "number"
      },
      "notice": {
        "description": "Recovery guidance when one or more identifiers were not found.",
        "type": "string"
      },
      "requestedCount": {
        "description": "Identifiers requested.",
        "type": "number"
      },
      "summaries": {
        "description": "Summary results.",
        "items": {
          "additionalProperties": false,
          "description": "Per-identifier summary result.",
          "properties": {
            "data": {
              "additionalProperties": false,
              "description": "Entity summary data. Populated fields depend on entityType.",
              "properties": {
                "aid": {
                  "description": "Assay ID — present on assay summaries.",
                  "type": "number"
                },
                "commonName": {
                  "description": "Common name (taxonomy summaries).",
                  "type": "string"
                },
                "description": {
                  "description": "Descriptive text when available.",
                  "type": "string"
                },
                "geneId": {
                  "description": "NCBI Gene ID (gene summaries).",
                  "type": "number"
                },
                "lineage": {
                  "description": "Taxonomic lineage ordered from the most inclusive rank to the most specific, e.g. [\"Eukaryota\", \"Metazoa\", \"Chordata\"] (taxonomy summaries). Ranks that do not apply to the entity are omitted.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "name": {
                  "description": "Primary display name.",
                  "type": "string"
                },
                "numActive": {
                  "description": "Substances marked active (assay summaries).",
                  "type": "number"
                },
                "numSubstances": {
                  "description": "Substances tested (assay summaries).",
                  "type": "number"
                },
                "proteinAccession": {
                  "description": "Protein accession (protein summaries).",
                  "type": "string"
                },
                "rank": {
                  "description": "Taxonomic rank (taxonomy summaries).",
                  "type": "string"
                },
                "scientificName": {
                  "description": "Scientific name (taxonomy summaries).",
                  "type": "string"
                },
                "sourceName": {
                  "description": "Data source attribution (assay summaries).",
                  "type": "string"
                },
                "symbol": {
                  "description": "Gene symbol (gene summaries).",
                  "type": "string"
                },
                "synonyms": {
                  "description": "Known synonyms / other names.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "taxonomy": {
                  "description": "Taxonomy scientific name (gene/protein summaries).",
                  "type": "string"
                },
                "taxonomyId": {
                  "description": "NCBI Taxonomy ID (gene/protein/taxonomy summaries).",
                  "type": "number"
                }
              },
              "type": "object"
            },
            "found": {
              "description": "Whether the entity was found.",
              "type": "boolean"
            },
            "identifier": {
              "anyOf": [
                {
                  "description": "String identifier (e.g. UniProt accession).",
                  "type": "string"
                },
                {
                  "description": "Numeric identifier (e.g. AID, Gene ID, Tax ID).",
                  "type": "number"
                }
              ],
              "description": "Queried identifier."
            }
          },
          "required": [
            "identifier",
            "found"
          ],
          "type": "object"
        },
        "type": "array"
      }
    },
    "type": "object"
  },
  "title": "Get Entity Summary"
}
```