Skip to main content
Glama

Africa Multiple collection overview

get_collection_overview
Read-onlyIdempotent

Start here: corpus counts, text coverage, breakdowns, dates, snapshot freshness and refresh status.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_collection_overview"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
countsYes
refreshYes
site_urlYes
universitiesNo
data_snapshotYes
collection_nameYes
items_by_languageNo
metadata_exposureNo
research_sectionsNo
chronicles_by_formNo
content_date_rangeYes
items_by_universityNo
items_by_resource_typeYes
items_by_research_sectionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / chronicles_by_form
      Added value: +{
      +  "additionalProperties": {
      +    "type": "number"
      +  },
      +  "type": "object"
      +}
  2. Changed12 schema fields changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / additionalProperties
      Removed value: -false
    • changedOutput schema / properties / content_date_range / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "earliest": {
      -        "type": "number"
      -      },
      -      "latest": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "earliest",
      -      "latest"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "earliest": {
      +        "type": "number"
      +      },
      +      "latest": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "earliest",
      +      "latest"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / counts / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / data_snapshot / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / items_by_language / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / items_by_research_section / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / items_by_resource_type / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / items_by_university / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / refresh / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / universities / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "collection_name": {
      +      "type": "string"
      +    },
      +    "content_date_range": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "earliest": {
      +              "type": "number"
      +            },
      +            "latest": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "earliest",
      +            "latest"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "counts": {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "data_snapshot": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "api_base": {
      +          "type": "string"
      +        },
      +        "fetched_at": {
      +          "type": "string"
      +        },
      +        "max_modified": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "note": {
      +          "type": "string"
      +        },
      +        "source": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source",
      +        "fetched_at",
      +        "max_modified",
      +        "api_base",
      +        "note"
      +      ],
      +      "type": "object"
      +    },
      +    "items_by_language": {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "items_by_research_section": {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "items_by_resource_type": {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "items_by_university": {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "metadata_exposure": {
      +      "type": "string"
      +    },
      +    "refresh": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "enabled": {
      +          "type": "boolean"
      +        },
      +        "error_class": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "in_flight": {
      +          "type": "boolean"
      +        },
      +        "last_attempt": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "last_success": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "enabled",
      +        "in_flight",
      +        "last_attempt",
      +        "last_success",
      +        "error_class"
      +      ],
      +      "type": "object"
      +    },
      +    "research_sections": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "site_url": {
      +      "type": "string"
      +    },
      +    "universities": {
      +      "additionalProperties": {
      +        "type": "string"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "collection_name",
      +    "site_url",
      +    "counts",
      +    "items_by_resource_type",
      +    "content_date_range",
      +    "data_snapshot",
      +    "refresh"
      +  ],
      +  "type": "object"
      +}
  4. First observed

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and a closed-world scope, so the safety profile is fully covered structurally. The description adds content-level context by noting that results include snapshot freshness and refresh status, implying the data may be stale or refreshed. It does not say whether the overview is cached or how large the response is.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence where the directive 'Start here' comes first and the content list follows; nothing is redundant. The term 'breakdowns' is vague and is the one element that does not fully earn its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description need not document return values, and annotations cover the safety profile; with zero parameters there is nothing else to specify. What remains is a high-level inventory of the overview's contents, which is sufficient for correct invocation, though it does not explain what 'refresh status' means operationally.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is no parameter semantics to explain and the baseline of 4 applies. The description correctly implies no scoping or filtering input is required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description enumerates concrete contents (corpus counts, text coverage, breakdowns, dates, snapshot freshness, refresh status), so an agent knows this returns an aggregate summary rather than a single record. It lacks an explicit verb+resource statement like 'Returns a collection-level summary' and does not name a sibling it contrasts with, but the content list makes the resource identifiable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Start here' is an explicit ordering directive that tells the agent to call this before other tools, which is real when-to-use guidance. There are no when-not conditions or named alternatives (e.g., versus list_collections or compare_collections), so it stops short of full routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.