by AM-Digital-Research-Environment · TypeScript
Read-only access to AMIRA, the Africa Multiple research-data platform on Omeka S.
This MCP server provides read-only access to AMIRA, the Africa Multiple research-data platform on Omeka S. It is exposed via the server identified as io.github.AM-Digital-Research-Environment/amira-mcp-server.
Captured live from the server via tools/list.
Start here: corpus counts, text coverage, breakdowns, dates, snapshot freshness and refresh status.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| keyword | string | optional | Every word must occur in the title, description, abstract, contents or identifiers; quote a phrase to match it exactly |
| subject | string | optional | Subject heading, partial (e.g. 'Architecture'). Subjects absorb the former free-form tags — there is no tag filter |
| location | string | optional | A place at ANY level of the city→country hierarchy: 'Nigeria' finds Lagos items, 'Lagos' finds only Lagos |
| location_id | integer | optional | Exact location authority ID, including descendants; avoids homonym matches |
| country | string | optional | Country only, exact name or common alias ('Côte d'Ivoire' = 'Ivory Coast'). Use `location` for cities |
| contributor | string | optional | A person/organisation credited on the item; either name order works |
| project_id | any | optional | Project Omeka id |
| research_section | string | optional | e.g. 'Arts & Aesthetics', 'Mobilities' |
| university | string | optional | ubt | unilag | ujkz | ufba | external — code or full name |
| resource_type | string | optional | e.g. 'Image', 'Text', 'Audio', 'Moving image' |
| genre | string | optional | Format/genre descriptor, partial (e.g. 'interview', 'letter', 'photograph') |
| collection | string | optional | Item-set title (partial) or id from list_collections |
| language | string | optional | Name or ISO code — 'French', 'fr', 'fra' and legacy 'fre' all match |
| year_from | integer | optional | Keep items whose content dates overlap from this year |
| year_to | integer | optional | Keep items whose content dates overlap up to this year |
| has_media | boolean | optional | true: only items with digitised files |
| added_since | string | optional | Added to AMIRA on or after this ISO date |
| modified_since | string | optional | Changed on or after this ISO date |
| export | string | optional | Return a file link instead of rows |
| limit | integer | optional | Default 20, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Every word must occur in the title, description, abstract, contents or identifiers; quote a phrase to match it exactly",
"type": "string",
"maxLength": 1000
},
"subject": {
"description": "Subject heading, partial (e.g. 'Architecture'). Subjects absorb the former free-form tags — there is no tag filter",
"type": "string",
"maxLength": 1000
},
"location": {
"description": "A place at ANY level of the city→country hierarchy: 'Nigeria' finds Lagos items, 'Lagos' finds only Lagos",
"type": "string",
"maxLength": 1000
},
"location_id": {
"description": "Exact location authority ID, including descendants; avoids homonym matches",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"country": {
"description": "Country only, exact name or common alias ('Côte d'Ivoire' = 'Ivory Coast'). Use `location` for cities",
"type": "string",
"maxLength": 1000
},
"contributor": {
"description": "A person/organisation credited on the item; either name order works",
"type": "string",
"maxLength": 1000
},
"project_id": {
"description": "Project Omeka id",
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
]
},
"research_section": {
"description": "e.g. 'Arts & Aesthetics', 'Mobilities'",
"type": "string",
"maxLength": 1000
},
"university": {
"description": "ubt | unilag | ujkz | ufba | external — code or full name",
"type": "string",
"maxLength": 1000
},
"resource_type": {
"description": "e.g. 'Image', 'Text', 'Audio', 'Moving image'",
"type": "string",
"maxLength": 1000
},
"genre": {
"description": "Format/genre descriptor, partial (e.g. 'interview', 'letter', 'photograph')",
"type": "string",
"maxLength": 1000
},
"collection": {
"description": "Item-set title (partial) or id from list_collections",
"type": "string",
"maxLength": 1000
},
"language": {
"description": "Name or ISO code — 'French', 'fr', 'fra' and legacy 'fre' all match",
"type": "string",
"maxLength": 1000
},
"year_from": {
"description": "Keep items whose content dates overlap from this year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"description": "Keep items whose content dates overlap up to this year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"has_media": {
"description": "true: only items with digitised files",
"type": "boolean"
},
"added_since": {
"description": "Added to AMIRA on or after this ISO date",
"type": "string",
"maxLength": 40
},
"modified_since": {
"description": "Changed on or after this ISO date",
"type": "string",
"maxLength": 40
},
"export": {
"description": "Return a file link instead of rows",
"type": "string",
"enum": [
"csv",
"jsonl"
]
},
"limit": {
"description": "Default 20, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| id | any | required | Omeka id (the number ending its amira_url, e.g. 7392) or a typed id such as research_item:7392 |
| citation_format | string | optional | Export format for the generated citation: bibtex (default) → `bibtex`, ris → `ris`, csl-json → `csl_json` |
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
],
"description": "Omeka id (the number ending its amira_url, e.g. 7392) or a typed id such as research_item:7392"
},
"citation_format": {
"description": "Export format for the generated citation: bibtex (default) → `bibtex`, ris → `ris`, csl-json → `csl_json`",
"type": "string",
"enum": [
"bibtex",
"ris",
"csl-json"
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Search project names, descriptions and membership. Returns cited summaries and item counts; use get_project for detail.
| keyword | string | optional | Matches the project name, an acronym or the description |
| university | string | optional | ubt | unilag | ujkz | ufba | external — code or name. A data facet, not a full AMRC list |
| research_section | string | optional | Name or id, e.g. 'Knowledges' |
| principal_investigator | string | optional | A PI name; either order works ('Oliver Baumann' finds 'Baumann, Oliver') |
| member | string | optional | A project member's name; either order works |
| institution | string | optional | Funding/affiliated institution name, partial |
| limit | integer | optional | Default 25, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Matches the project name, an acronym or the description",
"type": "string",
"maxLength": 1000
},
"university": {
"description": "ubt | unilag | ujkz | ufba | external — code or name. A data facet, not a full AMRC list",
"type": "string",
"maxLength": 1000
},
"research_section": {
"description": "Name or id, e.g. 'Knowledges'",
"type": "string",
"maxLength": 1000
},
"principal_investigator": {
"description": "A PI name; either order works ('Oliver Baumann' finds 'Baumann, Oliver')",
"type": "string",
"maxLength": 1000
},
"member": {
"description": "A project member's name; either order works",
"type": "string",
"maxLength": 1000
},
"institution": {
"description": "Funding/affiliated institution name, partial",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 25, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Project description, team, sections, funders, item counts by type, top subjects and ten sample research items, with citation links.
| id | any | required | Project Omeka id (e.g. 37700) or typed id project:37700 |
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "number"
}
],
"description": "Project Omeka id (e.g. 37700) or typed id project:37700"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Cluster research sections, funding phases, project/item counts and citation links. Includes the external-collection grouping.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}One research section's description, team and projects, each with its research-item count.
| name | string | optional | Section name, e.g. 'Arts & Aesthetics' |
| id | any | optional | Section Omeka id or typed id section:218 |
{
"type": "object",
"properties": {
"name": {
"description": "Section name, e.g. 'Arts & Aesthetics'",
"type": "string",
"maxLength": 1000
},
"id": {
"description": "Section Omeka id or typed id section:218",
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "number"
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Find canonical person authority records. Names accept either order and ignore accents. Use resolve_entity to disambiguate homonyms.
| keyword | string | optional | Matches the name, a name variant or an affiliation |
| affiliation | string | optional | Matches the person's affiliations only |
| limit | integer | optional | Default 25, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Matches the name, a name variant or an affiliation",
"type": "string",
"maxLength": 1000
},
"affiliation": {
"description": "Matches the person's affiliations only",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 25, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Person affiliations, authority identifiers, PI/member projects, credited items, publications and top collaborators. Lists cap at 50 with totals. Use id to disambiguate.
| name | string | optional | Full name in either order, with or without accents: 'Beier, Ulli' and 'Ulli Beier' both resolve |
| id | any | optional | Exact person Omeka id or typed id (person:123); required to disambiguate homonyms |
{
"type": "object",
"properties": {
"name": {
"description": "Full name in either order, with or without accents: 'Beier, Ulli' and 'Ulli Beier' both resolve",
"type": "string",
"maxLength": 1000
},
"id": {
"description": "Exact person Omeka id or typed id (person:123); required to disambiguate homonyms",
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"maxLength": 64
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Browse institution authorities by name or acronym (e.g. 'UJKZ'), with project counts and citation links.
| keyword | string | optional | Name or acronym, partial |
| limit | integer | optional | Default 50, max 200 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Name or acronym, partial",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 50, max 200",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Institution or group profile: identifiers, members, funded projects and credited items, with citation links.
| name | string | optional | Institution or group name, or an acronym |
| id | any | optional | Omeka id or typed id organisation:1224 |
{
"type": "object",
"properties": {
"name": {
"description": "Institution or group name, or an acronym",
"type": "string",
"maxLength": 1000
},
"id": {
"description": "Omeka id or typed id organisation:1224",
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "number"
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Cluster partner institutions grouped by catalogue category, with citation links.
| category | string | optional | Optional: amrc | privileged | cooperation | global, or a category label |
{
"type": "object",
"properties": {
"category": {
"description": "Optional: amrc | privileged | cooperation | global, or a category label",
"type": "string",
"maxLength": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Browse research groups and associations by name, with citation links.
| keyword | string | optional | Name or acronym, partial |
| limit | integer | optional | Default 50, max 200 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Name or acronym, partial",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 50, max 200",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Subject headings (LCSH or free tags) ranked by distinct research-item count. Feed a heading into search_research_items.subject.
| keyword | string | optional | Substring filter on the subject heading |
| vocabulary | string | optional | Only Library of Congress headings or only free tags |
| limit | integer | optional | Default 50, max 300 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Substring filter on the subject heading",
"type": "string",
"maxLength": 1000
},
"vocabulary": {
"description": "Only Library of Congress headings or only free tags",
"type": "string",
"enum": [
"lcsh",
"tag"
]
},
"limit": {
"description": "Default 50, max 300",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Research places with coordinates and ancestor rollups. One item can count under both city and country. Feed a name into search_research_items.location.
| filters | object | optional | Research-item filters applied before place counts |
| country | string | optional | One country, exact name or alias, plus its cities |
| keyword | string | optional | Substring filter on the place name |
| near | object | optional | Places within km of a point |
| bbox | array | optional | [west, south, east, north] |
| limit | integer | optional | Default 50, max 300 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"filters": {
"description": "Research-item filters applied before place counts",
"type": "object",
"properties": {
"keyword": {
"type": "string",
"maxLength": 1000
},
"subject": {
"type": "string",
"maxLength": 1000
},
"location": {
"type": "string",
"maxLength": 1000
},
"country": {
"type": "string",
"maxLength": 1000
},
"contributor": {
"type": "string",
"maxLength": 1000
},
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"research_section": {
"type": "string",
"maxLength": 1000
},
"university": {
"type": "string",
"maxLength": 1000
},
"resource_type": {
"type": "string",
"maxLength": 1000
},
"genre": {
"type": "string",
"maxLength": 1000
},
"collection": {
"type": "string",
"maxLength": 1000
},
"language": {
"type": "string",
"maxLength": 1000
},
"year_from": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"has_media": {
"type": "boolean"
},
"added_since": {
"type": "string",
"maxLength": 40
},
"modified_since": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"country": {
"description": "One country, exact name or alias, plus its cities",
"type": "string",
"maxLength": 1000
},
"keyword": {
"description": "Substring filter on the place name",
"type": "string",
"maxLength": 1000
},
"near": {
"description": "Places within km of a point",
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"km": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"latitude",
"longitude",
"km"
],
"additionalProperties": false
},
"bbox": {
"description": "[west, south, east, north]",
"minItems": 4,
"maxItems": 4,
"type": "array",
"items": {
"type": "number"
}
},
"limit": {
"description": "Default 50, max 300",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Omeka item sets ranked by research-item count, with catalogue links. Feed an ID into search_research_items.collection.
| keyword | string | optional | Substring filter on the collection title |
| limit | integer | optional | Default 50, max 200 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Substring filter on the collection title",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 50, max 200",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ranked formats, languages or resource types used by research items. Feed values into the corresponding search filters.
| category | string | required | 'genres' is an alias of 'formats'. The former 'tags' facet is merged into subjects — use list_subjects |
| keyword | string | optional | Substring filter on the value |
| limit | integer | optional | Default 100, max 500 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"formats",
"genres",
"languages",
"resource_types"
],
"description": "'genres' is an alias of 'formats'. The former 'tags' facet is merged into subjects — use list_subjects"
},
"keyword": {
"description": "Substring filter on the value",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 100, max 500",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"category"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Research-item year/decade histogram with dated and undated counts. A date range counts in each spanned bucket. Supports shared item filters and pagination.
| filters | object | optional | Research-item filters applied before bucketing |
| bucket | string | optional | Default 'year' |
| from | integer | optional | Earliest year to report (inclusive) |
| to | integer | optional | Latest year to report (inclusive) |
| sort | string | optional | Default 'chronological' (oldest first); 'count' ranks by item count |
| limit | integer | optional | Default 200, max 500 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"filters": {
"description": "Research-item filters applied before bucketing",
"type": "object",
"properties": {
"keyword": {
"type": "string",
"maxLength": 1000
},
"subject": {
"type": "string",
"maxLength": 1000
},
"location": {
"type": "string",
"maxLength": 1000
},
"country": {
"type": "string",
"maxLength": 1000
},
"contributor": {
"type": "string",
"maxLength": 1000
},
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"research_section": {
"type": "string",
"maxLength": 1000
},
"university": {
"type": "string",
"maxLength": 1000
},
"resource_type": {
"type": "string",
"maxLength": 1000
},
"genre": {
"type": "string",
"maxLength": 1000
},
"collection": {
"type": "string",
"maxLength": 1000
},
"language": {
"type": "string",
"maxLength": 1000
},
"year_from": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"has_media": {
"type": "boolean"
},
"added_since": {
"type": "string",
"maxLength": 40
},
"modified_since": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"bucket": {
"description": "Default 'year'",
"type": "string",
"enum": [
"year",
"decade"
]
},
"from": {
"description": "Earliest year to report (inclusive)",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"to": {
"description": "Latest year to report (inclusive)",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"sort": {
"description": "Default 'chronological' (oldest first); 'count' ranks by item count",
"type": "string",
"enum": [
"chronological",
"count"
]
},
"limit": {
"description": "Default 200, max 500",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| keyword | string | optional | Title, abstracts, venue, subjects or full text; every word must match, quote a phrase |
| author | string | optional | Author/editor name, either name order |
| type | string | optional | Exact type; discover values with list_publication_facets |
| venue | string | optional | Journal/book title, partial |
| subject | string | optional | Subject heading, partial |
| language | string | optional | Language name or ISO code |
| has_fulltext | boolean | optional | Filter by extracted full-text availability |
| year_from | integer | optional | |
| year_to | integer | optional | |
| added_since | string | optional | Added to AMIRA on or after this ISO date |
| citation_format | string | optional | Omit for summaries; pages carry bibtex, ris or csl_json |
| export | string | optional | Return a file link instead of rows |
| limit | integer | optional | Default 25; max 100 summaries or 25 exports, also byte-bounded |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Title, abstracts, venue, subjects or full text; every word must match, quote a phrase",
"type": "string",
"maxLength": 1000
},
"author": {
"description": "Author/editor name, either name order",
"type": "string",
"maxLength": 1000
},
"type": {
"description": "Exact type; discover values with list_publication_facets",
"type": "string",
"maxLength": 1000
},
"venue": {
"description": "Journal/book title, partial",
"type": "string",
"maxLength": 1000
},
"subject": {
"description": "Subject heading, partial",
"type": "string",
"maxLength": 1000
},
"language": {
"description": "Language name or ISO code",
"type": "string",
"maxLength": 1000
},
"has_fulltext": {
"description": "Filter by extracted full-text availability",
"type": "boolean"
},
"year_from": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"added_since": {
"description": "Added to AMIRA on or after this ISO date",
"type": "string",
"maxLength": 40
},
"citation_format": {
"description": "Omit for summaries; pages carry bibtex, ris or csl_json",
"type": "string",
"enum": [
"bibtex",
"ris",
"csl-json"
]
},
"export": {
"description": "Return a file link instead of rows",
"type": "string",
"enum": [
"csv",
"jsonl",
"bibtex",
"ris",
"csl-json"
]
},
"limit": {
"description": "Default 25; max 100 summaries or 25 exports, also byte-bounded",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Publication metadata and citation export (BibTeX default). Full text is opt-in and paginated. Cite amira_url; DOI/repository links are additional sources.
| id | any | required | Publication Omeka id or typed id publication:29919 |
| citation_format | string | optional | Default bibtex; selects bibtex, ris or csl_json field |
| include_fulltext | boolean | optional | Default false — set true to include the extracted full text |
| fulltext_offset | integer | optional | Start offset into the full text (chars), with include_fulltext |
| fulltext_max_chars | integer | optional | Max full-text characters to return (default/max 25000) |
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
],
"description": "Publication Omeka id or typed id publication:29919"
},
"citation_format": {
"description": "Default bibtex; selects bibtex, ris or csl_json field",
"type": "string",
"enum": [
"bibtex",
"ris",
"csl-json"
]
},
"include_fulltext": {
"description": "Default false — set true to include the extracted full text",
"type": "boolean"
},
"fulltext_offset": {
"description": "Start offset into the full text (chars), with include_fulltext",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"fulltext_max_chars": {
"description": "Max full-text characters to return (default/max 25000)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ranked facets for the entire filtered bibliography before pagination. Uses the same selection rules as search_publications.
| facet | string | required | |
| keyword | string | optional | Title, abstracts, venue, subjects or full text; every word must match, quote a phrase |
| author | string | optional | Author/editor name, either name order |
| type | string | optional | Exact type; discover values with list_publication_facets |
| venue | string | optional | Journal/book title, partial |
| subject | string | optional | Subject heading, partial |
| language | string | optional | Language name or ISO code |
| has_fulltext | boolean | optional | Filter by extracted full-text availability |
| year_from | integer | optional | |
| year_to | integer | optional | |
| added_since | string | optional | Added to AMIRA on or after this ISO date |
| limit | integer | optional | Default 25, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"facet": {
"type": "string",
"enum": [
"type",
"year",
"language",
"subject",
"author",
"venue"
]
},
"keyword": {
"description": "Title, abstracts, venue, subjects or full text; every word must match, quote a phrase",
"type": "string",
"maxLength": 1000
},
"author": {
"description": "Author/editor name, either name order",
"type": "string",
"maxLength": 1000
},
"type": {
"description": "Exact type; discover values with list_publication_facets",
"type": "string",
"maxLength": 1000
},
"venue": {
"description": "Journal/book title, partial",
"type": "string",
"maxLength": 1000
},
"subject": {
"description": "Subject heading, partial",
"type": "string",
"maxLength": 1000
},
"language": {
"description": "Language name or ISO code",
"type": "string",
"maxLength": 1000
},
"has_fulltext": {
"description": "Filter by extracted full-text availability",
"type": "boolean"
},
"year_from": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"added_since": {
"description": "Added to AMIRA on or after this ISO date",
"type": "string",
"maxLength": 40
},
"limit": {
"description": "Default 25, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"facet"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Publication venues ranked by linked bibliography records, with ISSN and catalogue links.
| keyword | string | optional | Substring filter on the journal title |
| limit | integer | optional | Default 50, max 200 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Substring filter on the journal title",
"type": "string",
"maxLength": 1000
},
"limit": {
"description": "Default 50, max 200",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| entity_type | string | required | What the value denotes. Tags are merged into subjects — there is no tag pivot |
| value | string | required | 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 |
| limit | integer | optional | Per-list cap, default 20, max 50 |
{
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"subject",
"location",
"person",
"project"
],
"description": "What the value denotes. Tags are merged into subjects — there is no tag pivot"
},
"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"
},
"limit": {
"description": "Per-list cap, default 20, max 50",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"entity_type",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Search podcast metadata and transcripts. Text-only hits include snippets; full transcripts require get_podcast with opt-in.
| keyword | string | optional | Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly |
| series | string | optional | Series title, partial (e.g. 'Cluster Conversations') |
| person | string | optional | A speaker/host name; either name order works |
| language | string | optional | Name or ISO code — 'French', 'fr', 'fra' all match |
| year_from | integer | optional | Earliest year |
| year_to | integer | optional | Latest year |
| limit | integer | optional | Default 20, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly",
"type": "string",
"maxLength": 1000
},
"series": {
"description": "Series title, partial (e.g. 'Cluster Conversations')",
"type": "string",
"maxLength": 1000
},
"person": {
"description": "A speaker/host name; either name order works",
"type": "string",
"maxLength": 1000
},
"language": {
"description": "Name or ISO code — 'French', 'fr', 'fra' all match",
"type": "string",
"maxLength": 1000
},
"year_from": {
"description": "Earliest year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"description": "Latest year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"limit": {
"description": "Default 20, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Podcast detail, duration, audio file and citation link; says which model generated the transcript. Transcript is opt-in, bounded and pageable.
| id | any | required | Podcast id from search_podcasts, e.g. 39121, or podcast:39121 |
| include_transcript | boolean | optional | Default false — set true to include the transcript text |
| transcript_offset | integer | optional | Start offset into the transcript (chars), with include_transcript |
| transcript_max_chars | integer | optional | Max transcript characters to return (default/max 25000) |
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
],
"description": "Podcast id from search_podcasts, e.g. 39121, or podcast:39121"
},
"include_transcript": {
"description": "Default false — set true to include the transcript text",
"type": "boolean"
},
"transcript_offset": {
"description": "Start offset into the transcript (chars), with include_transcript",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"transcript_max_chars": {
"description": "Max transcript characters to return (default/max 25000)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Search video metadata and transcripts. Text-only hits include snippets; full transcripts require get_video with opt-in.
| keyword | string | optional | Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly |
| playlist | string | optional | Playlist title, partial |
| speaker | string | optional | A speaker name; either name order works |
| language | string | optional | Name or ISO code — 'French', 'fr', 'fra' all match |
| year_from | integer | optional | Earliest year |
| year_to | integer | optional | Latest year |
| limit | integer | optional | Default 20, max 100 |
| offset | integer | optional |
{
"type": "object",
"properties": {
"keyword": {
"description": "Every word must occur in the title, abstract or transcript; quote a phrase to match it exactly",
"type": "string",
"maxLength": 1000
},
"playlist": {
"description": "Playlist title, partial",
"type": "string",
"maxLength": 1000
},
"speaker": {
"description": "A speaker name; either name order works",
"type": "string",
"maxLength": 1000
},
"language": {
"description": "Name or ISO code — 'French', 'fr', 'fra' all match",
"type": "string",
"maxLength": 1000
},
"year_from": {
"description": "Earliest year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"description": "Latest year",
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"limit": {
"description": "Default 20, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Video detail, thumbnail and citation link; says how the transcript was produced when recorded. Transcript is opt-in, bounded and pageable.
| id | any | required | Video id from search_videos, e.g. 39218, or video:39218 |
| include_transcript | boolean | optional | Default false — set true to include the transcript text |
| transcript_offset | integer | optional | Start offset into the transcript (chars), with include_transcript |
| transcript_max_chars | integer | optional | Max transcript characters to return (default/max 25000) |
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
}
],
"description": "Video id from search_videos, e.g. 39218, or video:39218"
},
"include_transcript": {
"description": "Default false — set true to include the transcript text",
"type": "boolean"
},
"transcript_offset": {
"description": "Start offset into the transcript (chars), with include_transcript",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"transcript_max_chars": {
"description": "Max transcript characters to return (default/max 25000)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| query | string | required | |
| type | string | optional | |
| limit | integer | optional | |
| offset | integer | optional |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"type": {
"type": "string",
"enum": [
"person",
"project",
"section",
"organisation",
"location",
"subject",
"format",
"language",
"collection",
"research_item",
"publication",
"journal",
"podcast",
"video",
"playlist"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}One-hop graph from a typed ID: explicit catalogue links and derived co-occurrence with distinct-record counts and cited evidence. Pass edge_id to page its evidence; pin snapshot_id across pages.
| seed | string | required | |
| max_nodes | integer | optional | Default 40, max 100 |
| max_edges | integer | optional | Default 50, max 200 |
| edge_id | string | optional | |
| snapshot_id | string | optional | |
| offset | integer | optional | |
| limit | integer | optional | Evidence page size, default 20, max 50 |
{
"type": "object",
"properties": {
"seed": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"max_nodes": {
"description": "Default 40, max 100",
"type": "integer",
"minimum": 2,
"maximum": 9007199254740991
},
"max_edges": {
"description": "Default 50, max 200",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"edge_id": {
"type": "string",
"maxLength": 64
},
"snapshot_id": {
"type": "string",
"maxLength": 64
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"description": "Evidence page size, default 20, max 50",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"seed"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| ids | array | required | publication:, video: or podcast: ids |
| keyword | string | required | |
| radius | integer | optional | |
| offset | integer | optional | |
| limit | integer | optional | Default 10, max 20 |
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"description": "publication:, video: or podcast: ids"
},
"keyword": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"radius": {
"type": "integer",
"minimum": 20,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"description": "Default 10, max 20",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"ids",
"keyword"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Compare 2–4 projects or item sets with identical research-item filters. Reports denominators, missingness, dates and top types/languages; collections can overlap.
| cohorts | array | required | |
| filters | object | optional |
{
"type": "object",
"properties": {
"cohorts": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"project",
"collection"
]
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"type",
"id"
],
"additionalProperties": false
}
},
"filters": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"maxLength": 1000
},
"subject": {
"type": "string",
"maxLength": 1000
},
"location": {
"type": "string",
"maxLength": 1000
},
"country": {
"type": "string",
"maxLength": 1000
},
"contributor": {
"type": "string",
"maxLength": 1000
},
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"research_section": {
"type": "string",
"maxLength": 1000
},
"university": {
"type": "string",
"maxLength": 1000
},
"resource_type": {
"type": "string",
"maxLength": 1000
},
"genre": {
"type": "string",
"maxLength": 1000
},
"collection": {
"type": "string",
"maxLength": 1000
},
"language": {
"type": "string",
"maxLength": 1000
},
"year_from": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"year_to": {
"type": "integer",
"minimum": 0,
"maximum": 2200
},
"has_media": {
"type": "boolean"
},
"added_since": {
"type": "string",
"maxLength": 40
},
"modified_since": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
}
},
"required": [
"cohorts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Snapshot coverage and missing metadata, unresolved loaded-authority links, and sanitized refresh status. Missing catalogue metadata is not evidence of real-world absence.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| from_id | string | optional | |
| to_id | string | optional | |
| corpus | string | optional | |
| offset | integer | optional | |
| limit | integer | optional | Default 30, max 100 |
{
"type": "object",
"properties": {
"from_id": {
"type": "string",
"maxLength": 64
},
"to_id": {
"type": "string",
"maxLength": 64
},
"corpus": {
"type": "string",
"enum": [
"persons",
"organisations",
"locations",
"projects",
"research_sections",
"research_items",
"publications",
"journals",
"podcasts",
"videos",
"playlists",
"languages",
"item_sets",
"subjects"
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"description": "Default 30, max 100",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ranked search across items, publications, videos, podcasts, projects and sections. Returns typed IDs, titles and citation URLs. Fetch selected records for evidence.
| query | string | required | A few keywords, names, places or themes — e.g. 'Yoruba architecture'. Terms are matched individually, so concise queries beat full sentences |
| limit | integer | optional | Default 10, max 50 |
| types | array | optional | Restrict to these record kinds |
{
"type": "object",
"properties": {
"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"
},
"limit": {
"description": "Default 10, max 50",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"types": {
"description": "Restrict to these record kinds",
"type": "array",
"items": {
"type": "string",
"enum": [
"item",
"publication",
"video",
"podcast",
"project",
"section"
]
}
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}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.
| id | string | required | A typed record id from search (item:7392, pub:30001, video:…, podcast:…, project:…, section:…) or resolve_entity |
| include_transcript | boolean | optional | Default false — set true to append the video/podcast transcript |
| transcript_offset | integer | optional | Start offset into the transcript (chars), with include_transcript |
| transcript_max_chars | integer | optional | Max transcript characters to return (default/max 25000) |
| include_fulltext | boolean | optional | Default false — set true to append a publication's extracted full text |
| fulltext_offset | integer | optional | Start offset into the full text (chars), with include_fulltext |
| fulltext_max_chars | integer | optional | Max full-text characters to return (default/max 25000) |
| max_chars | integer | optional | Cap on the whole returned text body, default/max 25000 |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"description": "A typed record id from search (item:7392, pub:30001, video:…, podcast:…, project:…, section:…) or resolve_entity"
},
"include_transcript": {
"description": "Default false — set true to append the video/podcast transcript",
"type": "boolean"
},
"transcript_offset": {
"description": "Start offset into the transcript (chars), with include_transcript",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"transcript_max_chars": {
"description": "Max transcript characters to return (default/max 25000)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"include_fulltext": {
"description": "Default false — set true to append a publication's extracted full text",
"type": "boolean"
},
"fulltext_offset": {
"description": "Start offset into the full text (chars), with include_fulltext",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"fulltext_max_chars": {
"description": "Max full-text characters to return (default/max 25000)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_chars": {
"description": "Cap on the whole returned text body, default/max 25000",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}
Read-only Model Context Protocol server for the Africa Multiple Interactive Research Atlas (AMIRA), the research-data platform of the Africa Multiple Cluster of Excellence at the University of Bayreuth. AMIRA is published on the cluster's public Omeka S site at data.africamultiple.uni-bayreuth.de.
AMIRA is built and maintained by the Cluster's Digital Research Environment (DRE), its digital infrastructure unit. The DRE designs, builds, and maintains the data systems that connect researchers across the Africa Multiple Research Centres (AMRCs) and partner institutions worldwide. Curation and description are joint efforts with partners at the AMRCs in Université Joseph Ki-Zerbo, Rhodes University, the University of Lagos, and Moi University. Bayreuth hosts the coordinating DRE infrastructure and metadata layer. Federal University of Bahia is a privileged partner, not an AMRC.
Storage stays distributed by default: data remains in its local repository, while Bayreuth holds the metadata layer that points to it. Research data becomes findable without being relocated. High-quality metadata makes researchers' data more discoverable and their work more visible to a wider community of peers.
This server exposes AMIRA's projects, thematic research sections, ~4,000 digitised research items, people, institutions, groups, collections, the cluster bibliography with searchable full text (extracted from the open-access PDFs) and its journals, podcast episodes with transcripts, and the cluster's YouTube videos with searchable transcripts — as 33 core tools an LLM can query, five research-workflow prompts, and resources for citable records and bulk exports. From one MCP interface, clients can move across records and the places, languages, and subjects that connect them.
Every record carries an amira_url — its public page on the Omeka S site
(…/s/amira/item/<id>) — so findings can be cited as links back to the source.
AMIRA focuses on the Cluster's research data. For news, events, and general
information about the Africa Multiple Cluster of Excellence, visit
africamultiple.uni-bayreuth.de.
Coverage checked 6 October 2026: 3,975 research items (1,419 with digitised
media), 93 projects, 555 publications (60 with extracted full text), 87 journals,
43 podcast episodes, 140 videos and 3,085 subject authorities (646 Library of
Congress headings). Counts are a dated snapshot; use get_collection_overview for
what your running server actually holds. See the publication guide,
the changelog for what each release changed, and the
roadmap for further improvements.
The server is self-contained and offline-first. It reads from two sources:
.mcpb — crawled from the
public Omeka S REST API at build time and transformed into compact typed
records, so the server works fully offline with zero setup.End users need no API key, no credentials, and no VPN — it's the same openly published data that powers the public site.
Call get_collection_overview first to scope the data, then drill in.
| Tool | Purpose |
|---|---|
get_collection_overview | Counts and breakdowns across the whole collection + snapshot freshness |
search_research_items | Find items by keyword (every word must match; quote a phrase), subject, location (hierarchy-aware), country (exact, with aliases such as Côte d'Ivoire = Ivory Coast), contributor, project, section, university, resource type, format/genre, language, year, has_media, added_since / modified_since; `export=csv |
get_research_item | Full metadata for one item (by Omeka id or typed id): typed dates, roles with the affiliation at the time, places with their region/country chain, provenance as linked institutions, typed identifiers, collections, related items, media files and the IIIF manifest — plus a generated citation and a BibTeX/RIS/CSL-JSON export (citation_format) |
search_projects / get_project | Projects by keyword or acronym, university, section, PI, member, funder — detail with item breakdown, top subjects and sample items |
list_research_sections / get_research_section | Thematic sections with funding phases (AM 1.0 / AM 2.0), PIs, counts, projects; detail by name or id |
search_persons / get_person | People (either name order works) — profile with GND and other authority identifiers, projects, items, publications and top collaborators |
list_institutions / get_institution / list_cluster_partners / list_groups | Organisations (institutions, Africa Multiple partner categories, and research groups) by name, acronym or id, their projects, people and items |
list_subjects | Subject headings ranked by item frequency, each marked as a Library of Congress heading (with its id.loc.gov URI) or a free tag (`vocabulary=lcsh |
list_locations | Every place — countries and cities in one flat list (hierarchy rolled up) — ranked by item count, with coordinates and Wikidata ids; filter by country, name, near (radius) or bbox |
list_collections | Collections (item sets) ranked by research-item count, with IIIF collection links — pair with the collection filter |
list_categories | Facet values: formats/genres, languages, resource types |
list_years | Date histogram of research items by year or decade — coverage over time, most-covered year/decade |
search_publications / get_publication | Filter the bibliography by author, subject, language, type, venue, year, date added and full-text availability; search abstracts in every language and extracted PDF text. Detail adds every abstract with its language, linked authorities, conference/extent/access/thesis metadata. citation_format selects BibTeX/RIS/CSL-JSON per page; export links the whole result as one file |
list_publication_facets | Counts by type, year, language, subject, author/editor or venue across the complete filtered bibliography; ranked and paginated |
list_journals | The journals the cluster publishes in, ranked by publication count, with ISSN and country — pair with the venue filter |
find_related | Cross-entity discovery: pivot from a subject/place/person/project to co-occurring entities (incl. publications) |
search_podcasts / get_podcast | Cluster podcast episodes with searchable transcripts, filterable by language; detail gives the duration, audio file and the model that generated the transcript; transcript text is opt-in |
search_videos / get_video | The cluster's YouTube videos — full-text search over transcripts (match snippets; thumbnail; transcript opt-in on detail) |
resolve_entity | Resolve names or typed IDs (either vocabulary: item:7392 = research_item:7392); return separate candidates for homonyms and unreconciled literals |
get_entity_graph | Bounded one-hop graph with distinct explicit links/co-occurrences and paginated cited evidence |
get_text_passages | Find passages in selected publication/video/podcast records, with exact original-text offsets |
compare_collections | Compare 2–4 projects or collections using common filters, denominators and missingness |
get_data_quality | Snapshot coverage, missing metadata and unresolved-reference counts |
get_snapshot_changes | Page added, updated or deleted records across retained snapshots from the same instance |
Five prompts package multi-step research workflows. Hosts show them as slash
commands; their arguments autocomplete from the snapshot's own authority names, and
each restates the citation rules. They are listed through prompts/list, so they
add nothing to the per-turn tool payload.
| Prompt | Arguments | Workflow |
|---|---|---|
literature_review | topic, year_from?, year_to? | Facets, publications, full-text passages and related research data on a topic |
project_dossier | project | Team, holdings, periods, places and connections of one project |
person_profile | name | Disambiguation, profile, graph and publication list of one person |
place_report | place | Items, projects, subjects and periods for a country, city or region |
transcript_evidence | query | Quoted passages from transcripts and open-access full texts |
Resources expose data outside the tool calls:
| URI | Content |
|---|---|
amira://record/{kind}/{id} | Any record as citable JSON — the same projection as its get_* tool; kinds follow resolve_entity ids (research_item, publication, person, location, subject, …) |
amira://export/{corpus}/{format}/{query} | A filtered export (CSV/JSONL for research items; CSV/JSONL/BibTeX/RIS/CSL-JSON for publications). The search tools return these links as resource_links when called with export |
amira://dataset | A schema.org Dataset description of the served snapshot: counts, coverage, licence mix, funder and how to cite it |
AMIRA_TOOL_PROFILE=full is the default: 33 core tools, or 35 over HTTP.
research, discovery and visualization expose smaller documented subsets
(22/12/14 core tools respectively; HTTP adds search and fetch). Profiles are
fixed at startup; they reduce discovery cost, not access permissions. Tools
outside a profile are removed, and so are the apps that render them. See
src/toolProfiles.ts for the exact lists.
Typed ids work everywhere in either vocabulary (item: / research_item:,
pub: / publication:, section:, person:, organisation:, project:,
video:, podcast:), including the id of every get_* tool. Paged results
stop early, with response_limited: true and a correct next_offset, when a page
would exceed 40,000 characters — Claude Code moves larger tool results out of
the conversation. Error results carry the error as JSON text only.
Use resolve_entity before graph traversal; pass its typed id unchanged to
get_entity_graph. Graph edges count distinct source records, separate each
corpus, and distinguish catalogue links from co-occurrence. Neither co-occurrence
nor a shared subject establishes collaboration. Follow an edge with edge_id
and the returned snapshot_id for stable evidence paging. Graphs cap at 100 nodes,
200 edges and 42,000 JSON bytes, so check truncated.
get_text_passages takes 1–10 publication:ID (or pub:ID), video:ID or
podcast:ID identifiers. It returns at most 20 passages per page, original UTF-16
offsets and source citations; every match is reachable through next_offset
(scanned_matches_capped reports a document with more than 10,000 matches). These are extracted-text offsets, not
PDF page numbers or audio timestamps. get_snapshot_changes requires two local
same-source generations; it reports available history instead of inventing a diff.
| You ask… | The model uses… |
|---|---|
| "What does the collection hold on Islam?" | list_subjects keyword=Islam → search_research_items subject=Islam |
| "Show me all the French-language items" | search_research_items language=French (codes fr/fra/legacy fre work too) |
| "What has Ulli Beier contributed?" | get_person name="Ulli Beier" (resolves to 'Beier, Ulli') |
| "Which items come from Nigeria?" | search_research_items location=Nigeria (Lagos items count too — location walks the place hierarchy) or country=Nigeria (exact: Niger stays out) |
| "What does AMIRA hold from Côte d'Ivoire?" | search_research_items country="Côte d'Ivoire" (the authority stores "Ivory Coast"; common aliases resolve) |
| "What has been added since September?" | search_research_items added_since=2026-09-01 (or search_publications added_since=…) |
| "Which Lagos items have digitised images?" | search_research_items location=Lagos has_media=true → get_research_item for the files and IIIF manifest |
| "Give me all Islam-related items as a spreadsheet" | search_research_items subject=Islam export=csv → read the returned amira://export/… link |
| "What audio recordings are in the ILAM collection?" | search_research_items project_id=37700 resource_type=Audio |
| "In which talks does anyone discuss decoloniality?" | search_videos keyword=decolonial (matches inside transcripts, flagged matched_in) |
| "Which cluster publications discuss migration control — and what do they actually say?" | search_publications keyword="migration control" (matches inside the extracted full text, flagged matched_in) → get_publication include_fulltext=true |
| "How many French-language publications are there, and of which types?" | list_publication_facets facet=type language=fr → search_publications language=fr |
| "Export the French-language bibliography for my reference manager" | search_publications language=fr citation_format=ris → follow next_offset; combine the complete ris records |
| "Which journals does the cluster publish in?" | list_journals (ranked by publication count) |
| "What themes travel with Architecture across projects?" | find_related entity_type=subject value=Architecture |
| "When was this photograph taken?" | get_research_item → typed dates (created/collected/issued/…) |
| "Give me a citation for this item — and the BibTeX" | get_research_item → generated_citation + bibtex (citation_format=ris/csl-json for a reference manager) |
| "Which decade does the collection cover most?" | list_years bucket=decade sort=count |
A research-workflow skill ships in .claude/skills/amira-mcp/:
cluster context, a query workflow, a tool-by-task map, the citation discipline, and coverage caveats.
Install it either way:
amira-mcp-skill.zip from the
releases page and
unzip it into your Claude skills directory (e.g. ~/.claude/skills/) — it expands to
~/.claude/skills/amira-mcp/..claude/skills/amira-mcp/ folder from this repo there.Official extension; host support varies. SEP-2640 is now Final. The server follows the published Skills extension, including SHA-256 digests and byte sizes for every file. The zip above remains available for clients without extension support. The research tools and citation contract work either way.
The server also serves that same skill over the connection, following the
SEP-2640 extension
(io.modelcontextprotocol/skills). Nothing to download and nothing to keep in sync: a host that
implements the extension discovers the skill on connect, and the copy it gets is the one built into
the running server rather than a zip that may predate the tool surface it describes. It is the only
route that reaches the remote HTTP surface — ChatGPT, Claude.ai connectors and the APIs have no
local skills directory.
| Method | What it returns |
|---|---|
skills/list | The catalog: skill://amira-mcp/SKILL.md, its frontmatter, and a SHA-256 digest and byte size for every file |
skills/get | One skill by URI, to refresh digests without re-listing |
resources/read | Any single file — SKILL.md or a reference — read on demand |
resources/directory/read | One directory level at a time (skill://amira-mcp, skill://amira-mcp/references) |
Cost when unused: zero. Skill text is never injected into the server instructions or into any
tool description, so the tools/list payload — the part re-sent every turn — is byte-identical
whether or not a host supports the extension. Disclosure timing stays a host decision; the three
reference files load only when something actually reads them.
Set AMIRA_SKILLS=0 to drop the capability and the three methods entirely.
Download amira-mcp-server.mcpb from the
releases page
and double-click it. Claude Desktop shows an install dialog; click Install.
No further configuration is required. The latest tagged release carries the
current data; the rolling data-latest pre-release always tracks the freshest
site snapshot.
The .mcpb is the local, offline option for Claude Desktop. The same server can
also run as a remote Streamable HTTP endpoint — one HTTPS URL that ChatGPT,
Claude (web + desktop remote connectors), the OpenAI and Anthropic APIs, Cursor,
VS Code and other clients connect to by pasting a URL (no download, always-fresh
data). The remote surface serves the same 33 tools plus the
OpenAI-compatible search / fetch tools for ChatGPT research integrations (35
total). Access is unauthenticated — the data is public and read-only.
search takes plain keywords (matched term-by-term, not as an exact phrase),
with optional limit and types to keep the result set tight, and returns
ranked hits across research items, the bibliography (reaching into publication
full text), podcasts, videos, projects and research sections. The url on
search results and fetch documents is
always the AMIRA/Omeka public record page; DOI, YouTube/watch, and podcast/listen
URLs are kept as secondary metadata/text links. fetch returns one record's full
text by the id search hands back — for videos and podcasts the transcript is omitted by default
(metadata + description only, since a full one can run to tens of thousands of
characters), and include_transcript=true pulls it in — paged with
transcript_offset / transcript_max_chars (the same names get_video /
get_podcast use). Publication full text works the same way
(include_fulltext=true, paged with fulltext_offset / fulltext_max_chars,
matching get_publication), and max_chars caps the whole text body. The
appended window is sized against what max_chars leaves after the metadata
header, so *_returned_chars is exactly what landed in text and the next page
starts at offset + returned_chars with no gap.
npm run build && npm run start:http # → http://localhost:8787/mcp
# or, self-contained, via Docker:
docker build -t amira-mcp . && docker run -p 8787:8787 amira-mcp
Endpoints: POST /mcp (the MCP endpoint) and GET /healthz. Bind with PORT /
HOST.
ChatGPT → enable Developer mode under Settings → Security and login,
then add your server URL from ChatGPT Plugins. Research integrations use
search + fetch; see the current OpenAI setup guide.
Claude (web or desktop) → Settings → Connectors → Add custom connector
→ https://<your-host>/mcp.
OpenAI API (Responses) — point the mcp tool at the endpoint:
{ "type": "mcp", "server_label": "amira",
"server_url": "https://<your-host>/mcp",
"allowed_tools": ["search", "fetch"], "require_approval": "never" }
The multi-stage Dockerfile crawls a fresh snapshot at build time
and runs the self-contained bundle (no node_modules at runtime). On a Linux
host you can equally run it under systemd behind a reverse proxy:
# /etc/systemd/system/amira-mcp.service
[Service]
ExecStart=/usr/bin/node /opt/amira-mcp/server/http.js
Environment=PORT=8787 HOST=127.0.0.1 AMIRA_LIVE_REFRESH=true
Restart=always
User=www-data
location /mcp { proxy_pass http://127.0.0.1:8787/mcp; proxy_buffering off; client_max_body_size 64k; }
proxy_buffering off keeps the Streamable-HTTP/SSE responses flowing. The refresh uses AMIRA_SITE_BASE (the public HTTPS API by default), even when
co-located with Omeka. It performs a full crawl when changes are detected;
co-location does not eliminate API load. The server caps request bodies at 64 KiB
and rate-limit state at 10,000 clients. Configure connection, request-rate and
concurrency limits at the reverse proxy for public deployments; the in-process
limiter is a courtesy control. Shutdown cancels refresh work and gives HTTP
connections a ten-second drain window.
For a build that consumes a previously reviewed data/ snapshot without calling
Omeka during the build:
docker build --build-arg SNAPSHOT_STAGE=bundled -t amira-mcp .
The default SNAPSHOT_STAGE=fetch still crawls fresh data. Both stages validate the
snapshot. The image pins its base digest; npm ci uses the committed lockfile.
npm ci
npm run fetch-data # crawl the public Omeka API -> ./data snapshot (~1 min)
npm run typecheck # tsc --noEmit
npm run build # esbuild -> server/{index,http,fetchCli,lib}.js
npm test # unit tests: transform fixtures, folding, snapshot + store lifecycle,
# and the full tool layer against a fixture snapshot via
# InMemoryTransport (offline)
npm run test:live # integration tests against the live API (network)
npm run smoke # test/smoke/stdio.mjs: spawn the stdio server, exercise every tool offline
npm run smoke:http # test/smoke/http.mjs: spawn the HTTP server on a free port: search/fetch +
# parity, CORS preflight for both protocol revisions, the rate limiter
npm run weigh # token budget report (needs ./data — run fetch-data first)
npm run benchmark # offline latency baseline against ./data (30 warm samples per query)
Context is the scarcest resource a client has, so both halves of what this server
spends are measured and gated (scripts/weigh.mjs, estimating tokens as
bytes/4 — comparable to itself, not to a billing statement):
| what | budget | drift | |
|---|---|---|---|
| Surface | the tools/list payload, re-sent every turn | 14,000 tok per full-profile transport | fails over 3 % |
| Responses | each tool called at its maximum limit | 20,000 tok and < 45,000 characters per call | warns over 10 % |
No tool description is derived from the snapshot, so the surface is a pure
function of the code: test/unit/budget.test.mjs gates it offline against no
data at all, and asserts that the empty-store measurement still matches the
baseline recorded against the full snapshot. Response weight needs real data, so
npm run weigh -- --check runs in the smoke job instead. Drift there is only a
warning — a routine npm run fetch-data must not red the build — while the
absolute cap (Claude Code truncates tool results at 25,000 tokens) is fatal, as
is any probe whose call failed, since a structured refusal is ~60 tokens and
would otherwise sail under every ceiling.
Version 1.18 deliberately raises the full-profile ceiling to 14,000 estimated
tokens to accommodate six tools and useful output schemas. Smaller profile gates
remain 10,000 (research), 6,500 (discovery) and 9,500 (visualization).
The committed baseline records the exact surface size,
text bytes, serialized wire bytes (text and structured content both count) and the
snapshot it was measured on. Every response must also stay under 45,000 characters:
Claude Code stores any tool result over 50,000 characters in a file instead of the
conversation. Paged results and the graph are byte-bounded to fit.
When a change legitimately grows either number:
npm run weigh -- --update # rewrites test/token-baseline.json
Commit the diff. That is the point of the file: the cost of a new tool or a richer result summary lands in code review as a number instead of arriving unnoticed.
Pack the extension:
npm run prepack-mcpb # clean + typecheck + build + test + smoke
npm run validate:manifest
npm run pack-mcpb # -> amira-mcp-server.mcpb
scripts/census.mjs re-runs the property census behind the field mapping
(scripts/census-report.json) — rerun and diff it if the instance's templates
change. The design decisions behind it are in ROADMAP.md; CHANGELOG.md
records each release.
Three GitHub Actions cover pull requests and distribution (the two distribution workflows crawl the public API — no credentials):
CI (.github/workflows/ci.yml) — on pull requests and pushes to main:
type-checks once, then runs the offline unit suite (including the tool-surface
token budget) on Node.js 22, 24 and 26 on Linux and Node.js 24 on Windows, then
exercises both MCP transports, weighs every tool's response at its maximum
limit, and validates the MCPB manifest. The complete dependency audit fails on high or critical advisories.
A separate container job builds an offline fixture image and checks health.
Windows CI also packs a fixture extension and checks its file list. A
non-blocking job runs the official MCP conformance suite against the HTTP server.
Actions are pinned to commit SHAs; every job has a timeout.
Release (.github/workflows/release.yml) — on a pushed v* tag: checks the
tag against package.json, crawls a fresh snapshot, runs unit, live and smoke
tests, packs the .mcpb and zips the companion skill (amira-mcp-skill.zip) in a
read-only job; a separate publish job attaches both to the GitHub Release with
build-provenance attestations. A non-blocking job publishes server.json to the
MCP Registry.
Refresh data snapshot (.github/workflows/refresh-data.yml) — weekly and
on demand; rebuilds only when the transformed snapshot content hash changes, including
item-set and vocabulary changes, updating the rolling
data-latest pre-release.
Publishing from Actions requires a writable token. If the organization disables write permissions for the default workflow token, either (a) enable Read and write permissions under Organization → Settings → Actions → General → Workflow permissions, or (b) add a repo/org secret
RELEASE_TOKEN(a PAT or GitHub App token withcontents: write). The workflows usesecrets.RELEASE_TOKENwhen present and fall back to the default token.
| Env var | Extension setting | Default | Meaning |
|---|---|---|---|
AMIRA_LIVE_REFRESH | Refresh data from the live site | true | Probe + refresh the snapshot from the public API at startup and on the periodic interval |
AMIRA_REFRESH_INTERVAL_HOURS | — | 24 | When live refresh is on, repeat the freshness probe this often while the server is running; set 0 to disable periodic checks |
AMIRA_FULL_REFRESH_HOURS | — | 168 | Force a complete crawl after this snapshot age even if item signatures are unchanged; minimum 1 hour |
AMIRA_TOOL_PROFILE | — | full | full, research, discovery, or visualization; restart to change |
AMIRA_CACHE_DIR | Refreshed-data cache directory | ~/.amira-mcp/cache | Where refreshed snapshots are stored |
AMIRA_SITE_BASE | Site base URL (advanced) | https://data.africamultiple.uni-bayreuth.de | Base for citations + refresh (AMIRA_DASHBOARD_BASE is honoured with a deprecation warning) |
AMIRA_SITE_SLUG | — | amira | Omeka site slug used in amira_url |
AMIRA_DATA_DIR | — | bundled data/ | Override the bundled snapshot path (dev) |
AMIRA_EXPOSURE | — | full | Benchmark experiments only: restrict which metadata the tools expose (see below) |
AMIRA_SKILLS | — | on | Serve the companion skill over the finalized SEP-2640 extension. 0/false/off withdraws the capability and the skills/* methods |
PORT | — | 8787 | Port for the remote HTTP transport (server/http.js); ignored by the .mcpb |
HOST | — | 127.0.0.1 | HTTP bind address; set 0.0.0.0 explicitly for remote access. The Docker image sets this itself |
AMIRA_ALLOWED_ORIGINS | — | localhost, 127.0.0.1, [::1] | Comma-separated browser Origin hostnames or URLs allowed to call the HTTP endpoint. Server-to-server clients, which omit Origin, are unaffected. Add trusted web-client origins explicitly; wildcards are rejected. |
AMIRA_RATE_LIMIT | — | 120 | Requests/minute per client on /mcp (0 disables). A courtesy cap — queries operate on the in-memory snapshot — not a security control; /healthz is exempt |
AMIRA_TRUST_PROXY | — | false | Attribute requests to the address the reverse proxy observed: X-Real-IP, otherwise the X-Forwarded-For entry AMIRA_PROXY_HOPS from the right (never the client-supplied leftmost one). Enable it behind a proxy — otherwise every request comes from the proxy and all clients share one bucket — and never when clients connect directly |
AMIRA_PROXY_HOPS | — | 1 | Number of trusted proxies in front of the server, for reading X-Forwarded-For when X-Real-IP is absent. IPv6 clients are bucketed by /64 |
The cache lives under AMIRA_CACHE_DIR/<API identity hash>/. active.json names
the current immutable generations/<uuid>/ directory and two previous generations.
Unreferenced generations have a 24-hour cleanup grace period. Existing flat
snapshots and a same-source legacy cache/current remain readable; the first new
publication migrates a flat destination into generation history. npm run fetch-data
also writes the generation layout to data/; scripts must use loadSnapshot
rather than assuming data/manifest.json is active.
A crashed writer can leave writer.lock. Stop all processes using that cache,
confirm no writer is running, then remove that one lock file and restart. The
server deliberately never guesses whether an old lock is safe to steal. Failed
refreshes leave the last usable data available. /healthz, overview and data
quality report refresh attempt/success times, in-flight state and failure class.
Retries apply only to transient upstream failures, honor bounded Retry-After,
and abort after a 15-minute refresh deadline or shutdown. Probes cannot provide a
transactional Omeka snapshot; periodic complete crawls remain necessary.
AMIRA_EXPOSURE lets an evaluation run the same tasks under graded metadata
visibility — the "metadata mediation" condition of LLM-access studies. It is an
experiment flag, not an end-user setting; the default (full) is the normal
server. Existence flags (has_transcript / has_fulltext) stay visible at
every level; only content and relations are gated, and refusals are structured
errors (exposure_restricted / text_access_disabled) so a model can say why
it cannot answer rather than hallucinating.
| Level | The model sees |
|---|---|
minimal | Titles, types, dates, URLs, media flags. Keyword search matches titles only; entity/facet/relation tools and structured filters are refused |
descriptive | + descriptions, abstracts, tables of contents (searchable too) |
structured | + subjects, places, people, projects, sections, collections, venues — all filters and entity tools |
full | + transcripts and publication full text (default) |
Pure in-memory typed records. The Omeka JSON-LD is transformed once at
build time (src/transform.ts, evidence in scripts/census-report.json);
the runtime loads compact records and indexes them at startup. No native
bindings; the esbuild bundles are self-contained.
Offline-first with atomic refresh. Bundled snapshot + locked generation publication; the freshest manifest wins at startup (an old cache can never shadow a newer bundled snapshot).
Citations are uniform: every entity is an Omeka item, so every record
carries amira_url = <site>/s/amira/item/<o:id>.
Accent-insensitive matching everywhere (src/text.ts). The collection is
francophone-Africa-heavy and its authority records are not consistently
accented against the free text — "Côte d'Ivoire" is the subject heading while
item titles carry "Cote d'Ivoire". Every keyword comparison folds both sides
(NFD, drop combining marks, lowercase, and map curly quotes, dashes and the
ligatures œ/æ/ß to plain forms), so the answer no longer depends on which
spelling the caller guessed. Folds of large texts are memoised and dropped when
a refresh replaces the snapshot.
Interactive results (MCP Apps). Seven tools carry _meta.ui.resourceUri
pointing at a text/html;profile=mcp-app resource, so hosts implementing the
io.modelcontextprotocol/ui
extension (Claude, Claude Desktop) render the result inline. Every other
client ignores the _meta and gets exactly the same JSON.
| Tool | Resource | Renders |
|---|---|---|
get_collection_overview | ui://amira/overview | Stat tiles + ranked breakdowns by university, section, resource type and language |
list_years | ui://amira/timeline | Histogram of items per year or decade |
list_research_sections | ui://amira/sections | Gantt of the sections across the AM 1.0 / AM 2.0 funding phases, with a "now" marker |
find_related | ui://amira/related | Radial co-occurrence hub: the seed at the centre, one labelled sector per relation type |
get_entity_graph | ui://amira/graph | Typed entity graph, keyboard navigation and paginated evidence |
list_locations | ui://amira/map | Offline map, country filters, place table and item evidence |
search_publications | ui://amira/bibliography | Filterable bibliography and selection export |
The modules live in src/ui/: shell.ts holds the design tokens and shared
bar-chart primitive; bridge.ts bundles the official Apps SDK. Each app supplies
its own CSS and render function. The templates load nothing from the network — no
scripts, styles, fonts or tiles — so they need no _meta.ui.csp grants and
run in the strictest sandbox. App controls call an allowlisted set of read-only tools through the host.
Citation links and file downloads also go through host APIs. Every visual has
a table or text alternative. See app development and provenance.
Colours come from the DREVisualizations
Omeka module's theme (--primary / the Africa Multiple brand palette), so a
chart in the chat and the same chart on the AMIRA site read as one system, and
were validated against those surfaces rather than eyeballed — light #007a50
on #fdfcfa, dark #35a87d on #1b211e (the theme's own #3fb488 sits just
outside the dark lightness band, so the app steps one down). Every chart is
single-series, with the category on the axis label, so one accent is correct
and no legend is needed. The co-occurrence hub would nominally want six hues
for its six relation types, but no six-hue set from the brand palette survives
all-pairs CVD separation (the best candidates bottomed out at ΔE 2.4 under
deutan), so identity there is carried spatially — one labelled sector per
relation type — which also survives greyscale, print and forced-colors.
Verified against the current specification and TypeScript SDK documentation on 6 October 2026. The server speaks MCP 2026-07-28 on both transports, and still answers 2025-era clients unchanged.
It runs on the v2 TypeScript SDK — the scoped packages
(@modelcontextprotocol/server, /node, /client), not the frozen
@modelcontextprotocol/sdk v1 monolith. Two things are worth knowing if you
work on the entry points:
SUPPORTED_PROTOCOL_VERSIONS is the legacy
initialize ladder and stops at 2025-11-25; the SDK keeps the 2026 string
internal on purpose. createAmiraServer names the revision itself in
supportedProtocolVersions, which is what registers server/discover —
without it that method answers -32601.serveStdio(factory)
and createMcpHandler(factory) decide the era per connection/request and pin
an instance from the factory. Connecting a bare StdioServerTransport or
NodeStreamableHTTPServerTransport by hand serves the 2025 era only.Concretely on the wire: server/discover advertises ["2026-07-28"], results
carry resultType, and the cacheable results carry real ttlMs / cacheScope
(1 h public on tools/list, resources/list and server/discover; 24 h on
resources/read, whose ui:// app HTML is immutable per build) rather than the
SDK's conservative { ttlMs: 0, cacheScope: "private" } default. Back-compat is
the handler's legacy: 'stateless' default, which answers 2025-era traffic with
a fresh instance per request — the same shape this server always had.
The deprecations of that revision cost nothing here: Roots, Sampling, Logging
and Elicitation are all unused, logging goes to stderr, and tool order is
deterministic (registration order). CORS accepts both generations of headers
(Mcp-Session-Id/MCP-Protocol-Version and Mcp-Method/Mcp-Name/X-Mcp-Header).
If this server is part of how you found or analysed AMIRA material, please cite
it. The repository carries a CITATION.cff, so GitHub's Cite
this repository button will render BibTeX and APA for you.
@software{madore_amira_mcp_server,
author = {Madore, Frédérick},
title = {{AMIRA MCP Server}},
year = {2026},
publisher = {Africa Multiple Cluster of Excellence, University of Bayreuth},
url = {https://github.com/AM-Digital-Research-Environment/amira-mcp-server},
license = {MIT}
}
Cite the data separately from the software: individual records are citable
by their amira_url (https://data.africamultiple.uni-bayreuth.de/s/amira/item/<id>),
which is what every tool result returns for exactly this reason.
Built and maintained by the Digital Research Environment (DRE) of the Africa Multiple Cluster of Excellence, University of Bayreuth — the Cluster's digital infrastructure unit, which designs and runs the data systems behind AMIRA. Curation and description of the underlying records are joint efforts with partners at the Africa Multiple Research Centres (Université Joseph Ki-Zerbo, Rhodes University, University of Lagos, Moi University) and Federal University of Bahia.
Funded by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under Germany's Excellence Strategy — EXC 2052/1 — 390713894 (Africa Multiple: Reconfiguring African Studies).
MIT — see LICENSE. See also CONTRIBUTING.md and SECURITY.md.
Hosted server - connect over the network, no local install.
https://data.africamultiple.uni-bayreuth.de/mcpclaude_desktop_config.json
{
"mcpServers": {
"amira-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://data.africamultiple.uni-bayreuth.de/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.
Query databases from AI agents using connections configured in DBX.
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 90 tools.
Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite
Official PostHog MCP Server for product analytics, feature flags, experiments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
MCP server for interacting with the Supabase platform