Servers Playground How we check Add a server Log in

AMIRA — Africa Multiple Research Data

Working · 2.5 s

io.github.AM-Digital-Research-Environment/amira-mcp-serverv1.25.0

Read-only access to AMIRA, the Africa Multiple research-data platform on Omeka S.

Research & Knowledge

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://data.africamultiple.uni-bayreuth.de/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

compare_collections Read-only

Compare 2–4 projects or item sets with identical research-item filters. Reports denominators, missingness, dates and top types/languages; collections can overlap.

cohortsarray, required

filtersobject

AMIRA — Africa Multiple Research Data MCP server | mcptry

Tools (35)

compare_collections

Compare 2–4 projects or item sets with identical research-item filters. Reports denominators, missingness, dates and top types/languages; collections can overlap.

read-only

Argument	Type	Description
cohorts*	array
filters	object

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cohorts"
  ],
  "properties": {
    "cohorts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "type": {
            "enum": [
              "project",
              "collection"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 4,
      "minItems": 2
    },
    "filters": {
      "type": "object",
      "properties": {
        "genre": {
          "type": "string",
          "maxLength": 1000
        },
        "country": {
          "type": "string",
          "maxLength": 1000
        },
        "keyword": {
          "type": "string",
          "maxLength": 1000
        },
        "subject": {
          "type": "string",
          "maxLength": 1000
        },
        "year_to": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "language": {
          "type": "string",
          "maxLength": 1000
        },
        "location": {
          "type": "string",
          "maxLength": 1000
        },
        "has_media": {
          "type": "boolean"
        },
        "year_from": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "collection": {
          "type": "string",
          "maxLength": 1000
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 256
            },
            {
              "type": "integer",
              "maximum": 9007199254740991,
              "exclusiveMinimum": 0
            }
          ]
        },
        "university": {
          "type": "string",
          "maxLength": 1000
        },
        "added_since": {
          "type": "string",
          "maxLength": 40
        },
        "contributor": {
          "type": "string",
          "maxLength": 1000
        },
        "location_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        "resource_type": {
          "type": "string",
          "maxLength": 1000
        },
        "modified_since": {
          "type": "string",
          "maxLength": 40
        },
        "research_section": {
          "type": "string",
          "maxLength": 1000
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

fetch

Read a typed search result as a cited document. Full text/transcripts are opt-in and pageable; metadata and text respect exposure policy. Unknown ID returns an error.

read-only

Argument	Type	Description
id*	string	A typed record id from search (item:9902, pub:30001, video:…, podcast:…, project:…, section:…) or resolve_entity
max_chars	integer	Cap on the whole returned text body, default/max 25000
fulltext_offset	integer	Start offset into the full text (chars), with include_fulltext
include_fulltext	boolean	Default false — set true to append a publication's extracted full text
transcript_offset	integer	Start offset into the transcript (chars), with include_transcript
fulltext_max_chars	integer	Max full-text characters to return (default/max 25000)
include_transcript	boolean	Default false — set true to append the video/podcast transcript
transcript_max_chars	integer

find_related

Subjects, people, places and projects connected through shared records. Per-corpus counts deduplicate each record; subject/person seeds also include publications. Returns ambiguity and cited samples.

read-only

Argument	Type	Description
limit	integer	Per-list cap, default 20, max 50
value*	string	The entity to pivot on. subject: substring of a heading ('Islam'). location: any level of the city→country hierarchy ('Nigeria' includes Lagos items). person: a name in either order, accent-insensitive ('Beier, Ulli'). project: an Omeka id ('37700'), a legacy key, or a substring of the project label
entity_type*	string	What the value denotes. Tags are merged into subjects — there is no tag pivot

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "entity_type",
    "value"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Per-list cap, default 20, max 50"
    },
    "value": {
      "type": "string",
      "maxLength": 1000,
      "description": "The entity to pivot on. subject: substring of a heading ('Islam'). location: any level of the city→country hierarchy ('Nigeria' includes Lagos items). person: a name in either order, accent-insensitive ('Beier, Ulli'). project: an Omeka id ('37700'), a legacy key, or a substring of the project label"
    },
    "entity_type": {
      "enum": [
        "subject",
        "location",
        "person",
        "project"
      ],
      "type": "string",
      "description": "What the value denotes. Tags are merged into subjects — there is no tag pivot"
    }
  },
  "additionalProperties": false
}

get_collection_overview

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

get_data_quality

Snapshot coverage and missing metadata, unresolved loaded-authority links, and sanitized refresh status. Missing catalogue metadata is not evidence of real-world absence.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

get_entity_graph

One-hop graph from a typed ID: explicit catalogue links and derived co-occurrence with distinct-record counts and cited evidence. types filters neighbours before the bounds. Pass edge_id to page its evidence; pin snapshot_id across pages.

read-only

Argument	Type	Description
seed*	string
limit	integer	Evidence page size, default 20, max 50
types	array
offset	integer
edge_id	string
max_edges	integer	Default 50, max 200
max_nodes	integer	Default 40, max 100
snapshot_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "seed"
  ],
  "properties": {
    "seed": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Evidence page size, default 20, max 50"
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "person",
          "project",
          "section",
          "organisation",
          "location",
          "subject",
          "format",
          "language",
          "collection",
          "research_item",
          "publication",
          "journal",
          "podcast",
          "video",
          "playlist"
        ],
        "type": "string"
      },
      "maxItems": 15,
      "minItems": 1
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "edge_id": {
      "type": "string",
      "maxLength": 64
    },
    "max_edges": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 200"
    },
    "max_nodes": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 2,
      "description": "Default 40, max 100"
    },
    "snapshot_id": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

get_institution

Institution or group profile: identifiers, members, funded projects and credited items, with citation links.

read-only

Argument	Type	Description
id	any	Omeka id or typed id organisation:1224
name	string	Institution or group name, or an acronym

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "number"
        }
      ],
      "description": "Omeka id or typed id organisation:1224"
    },
    "name": {
      "type": "string",
      "maxLength": 1000,
      "description": "Institution or group name, or an acronym"
    }
  },
  "additionalProperties": false
}

get_person

Person affiliations, identifiers, project and section roles, credited items, publications, podcasts, videos and collaborators. Lists cap at 50 with totals. Use id to disambiguate.

read-only

Argument	Type	Description
id	any	Exact person Omeka id or typed id (person:123); required to disambiguate homonyms
name	string	Full name in either order, with or without accents: 'Beier, Ulli' and 'Ulli Beier' both resolve

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 64
        }
      ],
      "description": "Exact person Omeka id or typed id (person:123); required to disambiguate homonyms"
    },
    "name": {
      "type": "string",
      "maxLength": 1000,
      "description": "Full name in either order, with or without accents: 'Beier, Ulli' and 'Ulli Beier' both resolve"
    }
  },
  "additionalProperties": false
}

get_podcast

Podcast detail, duration, audio file and citation link; says which model generated the transcript. Transcript is opt-in, bounded and pageable.

read-only

Argument	Type	Description
id*	any	Podcast id from search_podcasts, e.g. 39121, or podcast:39121
transcript_offset	integer	Start offset into the transcript (chars), with include_transcript
include_transcript	boolean	Default false — set true to include the transcript text
transcript_max_chars	integer	Max transcript characters to return (default/max 25000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "number"
        }
      ],
      "description": "Podcast id from search_podcasts, e.g. 39121, or podcast:39121"
    },
    "transcript_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Start offset into the transcript (chars), with include_transcript"
    },
    "include_transcript": {
      "type": "boolean",
      "description": "Default false — set true to include the transcript text"
    },
    "transcript_max_chars": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Max transcript characters to return (default/max 25000)"
    }
  },
  "additionalProperties": false
}

get_project

Project description, team, sections, funders, item counts by type, top subjects and ten sample research items, with citation links.

read-only

Argument	Type	Description
id*	any	Project Omeka id (e.g. 37700) or typed id project:37700

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256
        },
        {
          "type": "number"
        }
      ],
      "description": "Project Omeka id (e.g. 37700) or typed id project:37700"
    }
  },
  "additionalProperties": false
}

get_publication

Publication metadata and citation export (BibTeX default). Full text is opt-in and paginated. Cite amira_url; DOI/repository links are additional sources.

read-only

Argument	Type	Description
id*	any	Publication Omeka id or typed id publication:29919
citation_format	string	Default bibtex; selects bibtex, ris or csl_json field
fulltext_offset	integer	Start offset into the full text (chars), with include_fulltext
include_fulltext	boolean	Default false — set true to include the extracted full text
fulltext_max_chars	integer	Max full-text characters to return (default/max 25000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "number"
        }
      ],
      "description": "Publication Omeka id or typed id publication:29919"
    },
    "citation_format": {
      "enum": [
        "bibtex",
        "ris",
        "csl-json"
      ],
      "type": "string",
      "description": "Default bibtex; selects bibtex, ris or csl_json field"
    },
    "fulltext_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Start offset into the full text (chars), with include_fulltext"
    },
    "include_fulltext": {
      "type": "boolean",
      "description": "Default false — set true to include the extracted full text"
    },
    "fulltext_max_chars": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Max full-text characters to return (default/max 25000)"
    }
  },
  "additionalProperties": false
}

get_research_item

Research-item metadata, linked entities, rights, media files, IIIF manifest and a generated citation (BibTeX/RIS/CSL-JSON). Long fields cap at 25,000 characters.

read-only

Argument	Type	Description
id*	any	Omeka id (the number ending its amira_url, e.g. 9902) or a typed id such as research_item:9902
citation_format	string	Export format for the generated citation: bibtex (default) → `bibtex`, ris → `ris`, csl-json → `csl_json`

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "number"
        }
      ],
      "description": "Omeka id (the number ending its amira_url, e.g. 9902) or a typed id such as research_item:9902"
    },
    "citation_format": {
      "enum": [
        "bibtex",
        "ris",
        "csl-json"
      ],
      "type": "string",
      "description": "Export format for the generated citation: bibtex (default) → `bibtex`, ris → `ris`, csl-json → `csl_json`"
    }
  },
  "additionalProperties": false
}

get_research_section

One research section's description, team and projects, each with its research-item count.

read-only

Argument	Type	Description
id	any	Section Omeka id or typed id section:218
name	string	Section name, e.g. 'Arts & Aesthetics'

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "number"
        }
      ],
      "description": "Section Omeka id or typed id section:218"
    },
    "name": {
      "type": "string",
      "maxLength": 1000,
      "description": "Section name, e.g. 'Arts & Aesthetics'"
    }
  },
  "additionalProperties": false
}

get_snapshot_changes

Page added/updated/deleted records between retained snapshots from this Omeka instance. Lists available snapshot IDs when fewer than two exist. For recent additions without history, use added_since on the search tools.

read-only

Argument	Type	Description
limit	integer	Default 30, max 100
to_id	string
corpus	string
offset	integer
from_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 30, max 100"
    },
    "to_id": {
      "type": "string",
      "maxLength": 64
    },
    "corpus": {
      "enum": [
        "persons",
        "organisations",
        "locations",
        "projects",
        "research_sections",
        "research_items",
        "publications",
        "journals",
        "podcasts",
        "videos",
        "playlists",
        "languages",
        "item_sets",
        "subjects"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "from_id": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

get_text_passages

Find literal accent-insensitive keyword passages in selected publication/video/podcast IDs. Original UTF-16 offsets, bounded context, and citations. Requires full text exposure; no semantic ranking.

read-only

Argument	Type	Description
ids*	array	publication:, video: or podcast: ids
limit	integer	Default 10, max 20
offset	integer
radius	integer
keyword*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ids",
    "keyword"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "publication:, video: or podcast: ids"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 10, max 20"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "radius": {
      "type": "integer",
      "maximum": 500,
      "minimum": 20
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

get_video

Video detail, thumbnail and citation link; says how the transcript was produced when recorded. Transcript is opt-in, bounded and pageable.

read-only

Argument	Type	Description
id*	any	Video id from search_videos, e.g. 39218, or video:39218
transcript_offset	integer	Start offset into the transcript (chars), with include_transcript
include_transcript	boolean	Default false — set true to include the transcript text
transcript_max_chars	integer	Max transcript characters to return (default/max 25000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "number"
        }
      ],
      "description": "Video id from search_videos, e.g. 39218, or video:39218"
    },
    "transcript_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Start offset into the transcript (chars), with include_transcript"
    },
    "include_transcript": {
      "type": "boolean",
      "description": "Default false — set true to include the transcript text"
    },
    "transcript_max_chars": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Max transcript characters to return (default/max 25000)"
    }
  },
  "additionalProperties": false
}

list_categories

Ranked formats, languages or resource types used by research items. Feed values into the corresponding search filters.

read-only

Argument	Type	Description
limit	integer	Default 100, max 500
offset	integer
keyword	string	Substring filter on the value
category*	string	'genres' is an alias of 'formats'. The former 'tags' facet is merged into subjects — use list_subjects

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "category"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 100, max 500"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Substring filter on the value"
    },
    "category": {
      "enum": [
        "formats",
        "genres",
        "languages",
        "resource_types"
      ],
      "type": "string",
      "description": "'genres' is an alias of 'formats'. The former 'tags' facet is merged into subjects — use list_subjects"
    }
  },
  "additionalProperties": false
}

list_cluster_partners

Cluster partner institutions grouped by catalogue category, with citation links.

read-only

Argument	Type	Description
category	string	Optional: amrc \| privileged \| cooperation \| global, or a category label

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "type": "string",
      "maxLength": 1000,
      "description": "Optional: amrc | privileged | cooperation | global, or a category label"
    }
  },
  "additionalProperties": false
}

list_collections

Omeka item sets ranked by research-item count, with catalogue links. Feed an ID into search_research_items.collection.

read-only

Argument	Type	Description
limit	integer	Default 50, max 200
offset	integer
keyword	string	Substring filter on the collection title

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 200"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Substring filter on the collection title"
    }
  },
  "additionalProperties": false
}

list_groups

Browse research groups and associations by name, with citation links.

read-only

Argument	Type	Description
limit	integer	Default 50, max 200
offset	integer
keyword	string	Name or acronym, partial

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 200"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or acronym, partial"
    }
  },
  "additionalProperties": false
}

list_institutions

Browse institution authorities by name or acronym (e.g. 'UJKZ'), with project counts and citation links.

read-only

Argument	Type	Description
limit	integer	Default 50, max 200
offset	integer
keyword	string	Name or acronym, partial

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 200"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or acronym, partial"
    }
  },
  "additionalProperties": false
}

list_journals

Publication venues ranked by linked bibliography records, with ISSN and catalogue links.

read-only

Argument	Type	Description
limit	integer	Default 50, max 200
offset	integer
keyword	string	Substring filter on the journal title

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 200"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Substring filter on the journal title"
    }
  },
  "additionalProperties": false
}

list_locations

Research places with coordinates and ancestor rollups. One item can count under both city and country. Feed a name into search_research_items.location.

read-only

Argument	Type	Description
bbox	array	[west, south, east, north]
near	object	Places within km of a point
limit	integer	Default 50, max 300
offset	integer
country	string	One country, exact name or alias, plus its cities
filters	object	Research-item filters applied before place counts
keyword	string	Substring filter on the place name

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "description": "[west, south, east, north]"
    },
    "near": {
      "type": "object",
      "required": [
        "latitude",
        "longitude",
        "km"
      ],
      "properties": {
        "km": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      },
      "description": "Places within km of a point",
      "additionalProperties": false
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 300"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "country": {
      "type": "string",
      "maxLength": 1000,
      "description": "One country, exact name or alias, plus its cities"
    },
    "filters": {
      "type": "object",
      "properties": {
        "genre": {
          "type": "string",
          "maxLength": 1000
        },
        "country": {
          "type": "string",
          "maxLength": 1000
        },
        "keyword": {
          "type": "string",
          "maxLength": 1000
        },
        "subject": {
          "type": "string",
          "maxLength": 1000
        },
        "year_to": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "language": {
          "type": "string",
          "maxLength": 1000
        },
        "location": {
          "type": "string",
          "maxLength": 1000
        },
        "has_media": {
          "type": "boolean"
        },
        "year_from": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "collection": {
          "type": "string",
          "maxLength": 1000
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 256
            },
            {
              "type": "integer",
              "maximum": 9007199254740991,
              "exclusiveMinimum": 0
            }
          ]
        },
        "university": {
          "type": "string",
          "maxLength": 1000
        },
        "added_since": {
          "type": "string",
          "maxLength": 40
        },
        "contributor": {
          "type": "string",
          "maxLength": 1000
        },
        "location_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        "resource_type": {
          "type": "string",
          "maxLength": 1000
        },
        "modified_since": {
          "type": "string",
          "maxLength": 40
        },
        "research_section": {
          "type": "string",
          "maxLength": 1000
        }
      },
      "description": "Research-item filters applied before place counts",
      "additionalProperties": false
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Substring filter on the place name"
    }
  },
  "additionalProperties": false
}

list_publication_facets

Ranked facets for the entire filtered bibliography before pagination. Uses the same selection rules as search_publications.

read-only

Argument	Type	Description
type	string	Exact type; discover values with list_publication_facets
facet*	string
limit	integer	Default 25, max 100
venue	string	Journal/book title, partial
author	string	Author/editor name, either name order
offset	integer
keyword	string	Title, abstracts, venue, subjects or full text; every word must match, quote a phrase
subject	string	Subject heading, partial
year_to	integer
language	string

list_research_sections

Cluster research sections, funding phases, project/item counts and citation links. Includes the external-collection grouping.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

list_subjects

Subject headings (LCSH or free tags) ranked by distinct research-item count. Feed a heading into search_research_items.subject.

read-only

Argument	Type	Description
limit	integer	Default 50, max 300
offset	integer
keyword	string	Substring filter on the subject heading
vocabulary	string	Only Library of Congress headings or only free tags

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 50, max 300"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Substring filter on the subject heading"
    },
    "vocabulary": {
      "enum": [
        "lcsh",
        "tag"
      ],
      "type": "string",
      "description": "Only Library of Congress headings or only free tags"
    }
  },
  "additionalProperties": false
}

list_years

Research-item year/decade histogram with dated and undated counts. A date range counts in each spanned bucket. Supports shared item filters and pagination.

read-only

Argument	Type	Description
to	integer	Latest year to report (inclusive)
from	integer	Earliest year to report (inclusive)
sort	string	Default 'chronological' (oldest first); 'count' ranks by item count
limit	integer	Default 200, max 500
bucket	string	Default 'year'
offset	integer
filters	object	Research-item filters applied before bucketing

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Latest year to report (inclusive)"
    },
    "from": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Earliest year to report (inclusive)"
    },
    "sort": {
      "enum": [
        "chronological",
        "count"
      ],
      "type": "string",
      "description": "Default 'chronological' (oldest first); 'count' ranks by item count"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 200, max 500"
    },
    "bucket": {
      "enum": [
        "year",
        "decade"
      ],
      "type": "string",
      "description": "Default 'year'"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "filters": {
      "type": "object",
      "properties": {
        "genre": {
          "type": "string",
          "maxLength": 1000
        },
        "country": {
          "type": "string",
          "maxLength": 1000
        },
        "keyword": {
          "type": "string",
          "maxLength": 1000
        },
        "subject": {
          "type": "string",
          "maxLength": 1000
        },
        "year_to": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "language": {
          "type": "string",
          "maxLength": 1000
        },
        "location": {
          "type": "string",
          "maxLength": 1000
        },
        "has_media": {
          "type": "boolean"
        },
        "year_from": {
          "type": "integer",
          "maximum": 2200,
          "minimum": 0
        },
        "collection": {
          "type": "string",
          "maxLength": 1000
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 256
            },
            {
              "type": "integer",
              "maximum": 9007199254740991,
              "exclusiveMinimum": 0
            }
          ]
        },
        "university": {
          "type": "string",
          "maxLength": 1000
        },
        "added_since": {
          "type": "string",
          "maxLength": 40
        },
        "contributor": {
          "type": "string",
          "maxLength": 1000
        },
        "location_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        "resource_type": {
          "type": "string",
          "maxLength": 1000
        },
        "modified_since": {
          "type": "string",
          "maxLength": 40
        },
        "research_section": {
          "type": "string",
          "maxLength": 1000
        }
      },
      "description": "Research-item filters applied before bucketing",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

resolve_entity

Resolve a label or typed ID to cited candidates. Returns ambiguity instead of merging names. Use a returned id with get_entity_graph or get_* tools.

read-only

Argument	Type	Description
type	string
limit	integer
query*	string
offset	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "person",
        "project",
        "section",
        "organisation",
        "location",
        "subject",
        "format",
        "language",
        "collection",
        "research_item",
        "publication",
        "journal",
        "podcast",
        "video",
        "playlist"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Ranked search across items, publications, videos, podcasts, projects and sections. Returns typed IDs, titles and citation URLs. Fetch selected records for evidence.

read-only

Argument	Type	Description
limit	integer	Default 10, max 50
query*	string	A few keywords, names, places or themes — e.g. 'Yoruba architecture'. Terms are matched individually, so concise queries beat full sentences
types	array	Restrict to these record kinds

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 10, max 50"
    },
    "query": {
      "type": "string",
      "maxLength": 1000,
      "description": "A few keywords, names, places or themes — e.g. 'Yoruba architecture'. Terms are matched individually, so concise queries beat full sentences"
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "item",
          "publication",
          "video",
          "podcast",
          "project",
          "section"
        ],
        "type": "string"
      },
      "description": "Restrict to these record kinds"
    }
  },
  "additionalProperties": false
}

search_persons

Find canonical person authority records. Names accept either order and ignore accents. Use resolve_entity to disambiguate homonyms.

read-only

Argument	Type	Description
limit	integer	Default 25, max 100
offset	integer
keyword	string	Matches the name, a name variant or an affiliation
affiliation	string	Matches the person's affiliations only

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 25, max 100"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Matches the name, a name variant or an affiliation"
    },
    "affiliation": {
      "type": "string",
      "maxLength": 1000,
      "description": "Matches the person's affiliations only"
    }
  },
  "additionalProperties": false
}

search_podcasts

Search podcast metadata and transcripts. Text-only hits include snippets; full transcripts require get_podcast with opt-in.

read-only

Argument	Type	Description
limit	integer	Default 20, max 100
offset	integer
person	string	A speaker/host name; either name order works
series	string	Series title, partial (e.g. 'Cluster Conversations')
keyword	string	Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly
year_to	integer	Latest year
language	string	Name or ISO code — 'French', 'fr', 'fra' all match
year_from	integer	Earliest year

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 20, max 100"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "person": {
      "type": "string",
      "maxLength": 1000,
      "description": "A speaker/host name; either name order works"
    },
    "series": {
      "type": "string",
      "maxLength": 1000,
      "description": "Series title, partial (e.g. 'Cluster Conversations')"
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly"
    },
    "year_to": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Latest year"
    },
    "language": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or ISO code — 'French', 'fr', 'fra' all match"
    },
    "year_from": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Earliest year"
    }
  },
  "additionalProperties": false
}

search_projects

Search project names, descriptions and membership. Returns cited summaries and item counts; use get_project for detail.

read-only

Argument	Type	Description
limit	integer	Default 25, max 100
member	string	A project member's name; either order works
offset	integer
keyword	string	Matches the project name, an acronym or the description
university	string	ubt \| unilag \| ujkz \| ufba \| external — code or name. A data facet, not a full AMRC list
institution	string	Funding/affiliated institution name, partial
research_section	string	Name or id, e.g. 'Knowledges'
principal_investigator	string	A PI name; either order works ('Oliver Baumann' finds 'Baumann, Oliver')

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 25, max 100"
    },
    "member": {
      "type": "string",
      "maxLength": 1000,
      "description": "A project member's name; either order works"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Matches the project name, an acronym or the description"
    },
    "university": {
      "type": "string",
      "maxLength": 1000,
      "description": "ubt | unilag | ujkz | ufba | external — code or name. A data facet, not a full AMRC list"
    },
    "institution": {
      "type": "string",
      "maxLength": 1000,
      "description": "Funding/affiliated institution name, partial"
    },
    "research_section": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or id, e.g. 'Knowledges'"
    },
    "principal_investigator": {
      "type": "string",
      "maxLength": 1000,
      "description": "A PI name; either order works ('Oliver Baumann' finds 'Baumann, Oliver')"
    }
  },
  "additionalProperties": false
}

search_publications

AND-filtered bibliography, newest first. Keyword includes PDF text and returns match snippets. citation_format returns citations per page; export links every match as one file. Cite amira_url.

read-only

Argument	Type	Description
type	string	Exact type; discover values with list_publication_facets
limit	integer	Default 25; max 100 summaries or 25 exports, also byte-bounded
venue	string	Journal/book title, partial
author	string	Author/editor name, either name order
export	string	Return a file link instead of rows
offset	integer
keyword	string	Title, abstracts, venue, subjects or full text; every word must match, quote a phrase
subject	string	Subject heading, partial
year_to	integer

search_research_items

Search digitised research items. Filters are AND-combined; empty results suggest a filter to relax or a stored place name. export links all matches as a file.

read-only

Argument	Type	Description
genre	string	Format/genre descriptor, partial (e.g. 'interview', 'letter', 'photograph')
limit	integer	Default 20, max 100
export	string	Return a file link instead of rows
offset	integer
country	string	Country only, exact name or common alias ('Côte d'Ivoire' = 'Ivory Coast'). Use `location` for cities
keyword	string	Every word must occur in the title, description, abstract, contents or identifiers; quote a phrase to match it exactly
subject	string	Subject heading, partial (e.g. 'Architecture'). Subjects absorb the former free-form tags — there is no tag filter
year_to	integer	Keep items whose content dates overlap up to this year
language

search_videos

Search video metadata and transcripts. Text-only hits include snippets; full transcripts require get_video with opt-in.

read-only

Argument	Type	Description
limit	integer	Default 20, max 100
offset	integer
keyword	string	Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly
speaker	string	A speaker name; either name order works
year_to	integer	Latest year
language	string	Name or ISO code — 'French', 'fr', 'fra' all match
playlist	string	Playlist title, partial
year_from	integer	Earliest year

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 20, max 100"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly"
    },
    "speaker": {
      "type": "string",
      "maxLength": 1000,
      "description": "A speaker name; either name order works"
    },
    "year_to": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Latest year"
    },
    "language": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or ISO code — 'French', 'fr', 'fra' all match"
    },
    "playlist": {
      "type": "string",
      "maxLength": 1000,
      "description": "Playlist title, partial"
    },
    "year_from": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Earliest year"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "type": "string",
      "maxLength": 1000,
      "description": "Exact type; discover values with list_publication_facets"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 25; max 100 summaries or 25 exports, also byte-bounded"
    },
    "venue": {
      "type": "string",
      "maxLength": 1000,
      "description": "Journal/book title, partial"
    },
    "author": {
      "type": "string",
      "maxLength": 1000,
      "description": "Author/editor name, either name order"
    },
    "export": {
      "enum": [
        "csv",
        "jsonl",
        "bibtex",
        "ris",
        "csl-json"
      ],
      "type": "string",
      "description": "Return a file link instead of rows"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Title, abstracts, venue, subjects or full text; every word must match, quote a phrase"
    },
    "subject": {
      "type": "string",
      "maxLength": 1000,
      "description": "Subject heading, partial"
    },
    "year_to": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0
    },
    "language": {
      "type": "string",
      "maxLength": 1000,
      "description": "Language name or ISO code"
    },
    "year_from": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0
    },
    "added_since": {
      "type": "string",
      "maxLength": 40,
      "description": "Added to AMIRA on or after this ISO date"
    },
    "has_fulltext": {
      "type": "boolean",
      "description": "Filter by extracted full-text availability"
    },
    "citation_format": {
      "enum": [
        "bibtex",
        "ris",
        "csl-json"
      ],
      "type": "string",
      "description": "Omit for summaries; pages carry bibtex, ris or csl_json"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "genre": {
      "type": "string",
      "maxLength": 1000,
      "description": "Format/genre descriptor, partial (e.g. 'interview', 'letter', 'photograph')"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Default 20, max 100"
    },
    "export": {
      "enum": [
        "csv",
        "jsonl"
      ],
      "type": "string",
      "description": "Return a file link instead of rows"
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0
    },
    "country": {
      "type": "string",
      "maxLength": 1000,
      "description": "Country only, exact name or common alias ('Côte d'Ivoire' = 'Ivory Coast'). Use `location` for cities"
    },
    "keyword": {
      "type": "string",
      "maxLength": 1000,
      "description": "Every word must occur in the title, description, abstract, contents or identifiers; quote a phrase to match it exactly"
    },
    "subject": {
      "type": "string",
      "maxLength": 1000,
      "description": "Subject heading, partial (e.g. 'Architecture'). Subjects absorb the former free-form tags — there is no tag filter"
    },
    "year_to": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Keep items whose content dates overlap up to this year"
    },
    "language": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name or ISO code — 'French', 'fr', 'fra' and legacy 'fre' all match"
    },
    "location": {
      "type": "string",
      "maxLength": 1000,
      "description": "A place at ANY level of the city→country hierarchy: 'Nigeria' finds Lagos items, 'Lagos' finds only Lagos"
    },
    "has_media": {
      "type": "boolean",
      "description": "true: only items with digitised files"
    },
    "year_from": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 0,
      "description": "Keep items whose content dates overlap from this year"
    },
    "collection": {
      "type": "string",
      "maxLength": 1000,
      "description": "Item-set title (partial) or id from list_collections"
    },
    "project_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "number"
        }
      ],
      "description": "Project Omeka id"
    },
    "university": {
      "type": "string",
      "maxLength": 1000,
      "description": "ubt | unilag | ujkz | ufba | external — code or full name"
    },
    "added_since": {
      "type": "string",
      "maxLength": 40,
      "description": "Added to AMIRA on or after this ISO date"
    },
    "contributor": {
      "type": "string",
      "maxLength": 1000,
      "description": "A person/organisation credited on the item; either name order works"
    },
    "location_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Exact location authority ID, including descendants; avoids homonym matches",
      "exclusiveMinimum": 0
    },
    "resource_type": {
      "type": "string",
      "maxLength": 1000,
      "description": "e.g. 'Image', 'Text', 'Audio', 'Moving image'"
    },
    "modified_since": {
      "type": "string",
      "maxLength": 40,
      "description": "Changed on or after this ISO date"
    },
    "research_section": {
      "type": "string",
      "maxLength": 1000,
      "description": "e.g. 'Arts & Aesthetics', 'Mobilities'"
    }
  },
  "additionalProperties": false
}