# AMIRA — Africa Multiple Research Data MCP server

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

## At a glance

AMIRA — Africa Multiple Research Data is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb`, and declares no required credentials. It exposes 29 tools, including get_collection_overview, search_research_items and get_research_item. It scores B (71/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install AMIRA — Africa Multiple Research Data in Claude Code

1. Add the server

```bash
claude mcp add amira-mcp-server -- npx -y https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. get_collection_overview, search_research_items, get_research_item). It discovers them automatically.

### How to install AMIRA — Africa Multiple Research Data in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "amira-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"
      ]
    }
  }
}
```

3. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install AMIRA — Africa Multiple Research Data in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "amira-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"
      ]
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install AMIRA — Africa Multiple Research Data in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.amira-mcp-server]
command = "npx"
args = ["-y", "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"]
```

2. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install AMIRA — Africa Multiple Research Data in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "amira-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"
      ]
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install AMIRA — Africa Multiple Research Data in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "amira-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"
      ]
    }
  }
}
```

### How to install AMIRA — Africa Multiple Research Data in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "amira-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/AM-Digital-Research-Environment/amira-mcp-server/releases/download/v1.31.1/amira-mcp-server.mcpb"
      ]
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `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, l
- `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 fil
- `search_projects` — Projects by keyword or acronym, university, section, PI, member, funder — detail with item breakdown, top subjects and sample items
- `list_research_sections` — Thematic sections with funding phases (AM 1.0 / AM 2.0), PIs, counts, projects; detail by name or id
- `search_persons` — People (either name order works) — profile with GND and other authority identifiers, project and research-section roles, items, publications, podcasts, videos and top collaborators, with a `coverage_note` on how to read the counts. A name t
- `list_institutions` — 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` — 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, con
- `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` — 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` — 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:9902` = `research_item:9902`); return separate candidates for homonyms and unreconciled literals. A query that resolves to nothing, untyped or with `type=person`, returns near-miss person
- `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
- `literature_review` — `topic`, `year_from?`, `year_to?`
- `project_dossier` — `project`
- `person_profile` — `name`
- `place_report` — `place`
- `transcript_evidence` — `query`

Source repository: https://github.com/AM-Digital-Research-Environment/amira-mcp-server

---

Source: https://mcp-skills-hub.vercel.app/mcps/io-github-am-digital-research-environment-amira-mcp-server · MCP Skills Hub · data as of 2026-10-28T12:31:05Z
