AIND Data MCP Server

Code Style Interrogate Coverage Python

An MCP (Model Context Protocol) server that provides access to AIND (Allen Institute for Neural Dynamics) metadata and data assets through a comprehensive set of tools and resources. This server targets the V2 aind-data-schema format.

Installation

{
    "servers": {
        "aind-data-mcp": {
            "url": "https://metadata-portal.allenneuraldynamics.org/mcp/",
            "type": "http"
        }
    },
    "inputs": []
}

Features

This MCP server provides the following tools:

Data Retrieval & Querying

get_records — Query MongoDB collections using filters and exact leaf-path projections; optionally return a reproducible result marker
aggregation_retrieval — Execute complex MongoDB aggregation pipelines, including logical aliases for legacy field paths
count_records — Count documents matching a filter
flatten_records — Retrieve and flatten records into dot-notation for easier inspection
get_project_names — List all project names in the database
get_summary — Generate an AI-powered summary for a specific data asset

Schema Navigation

get_schema_context — Explore compact V2 field paths by node and opt-in small examples
get_modality_types — List all available data modality names and abbreviations

The MCP initialize response includes a ready tool manifest. Use get_schema_context(node="subject", detail="example") only when a compact synthetic example is needed; ordinary path discovery does not load bulky schema examples.

NWB File Access

identify_nwb_contents_in_code_ocean — Load an NWB file from the /data directory in a Code Ocean capsule
identify_nwb_contents_with_s3_link — Load an NWB file from an S3 path

Resources (accessible via the MCP protocol)

resource://aind_api — Context and usage patterns for the AIND data access API
resource://load_nwbfile — Reference script for loading NWB files

Development

To develop the code, run

uv sync --extra dev

To run tests:

uv run coverage run -m unittest discover && uv run coverage report

To run linting:

uv run flake8 . && uv run interrogate --verbose .

Metadata

Release files for aind-data-mcp 0.4.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aind-data-mcp 0.4.16
File	Size	Uploaded
aind_data_mcp-0.4.16.tar.gz	31.4 kB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aind-data-mcp 0.4.16
File	Interpreter	ABI	Platform	Reset
aind_data_mcp-0.4.16-py3-none-any.whl 29.1 kB Sep 2, 2026	Python 3	none	any	Details

Total release size: 60.5 kB

Release files / aind_data_mcp-0.4.16.tar.gz

Download URL	aind_data_mcp-0.4.16.tar.gz
Size	31.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`dc4f05debdaf34878537d661b79401337693549d21112224dd18b08979df1d1a`
BLAKE2b-256 checksum How to use checksums	`b1534177f42f740299ef4c5d8769bf67e65dc33e2a62237b5bdd765ffabb148f`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / aind_data_mcp-0.4.16-py3-none-any.whl

Download URL	aind_data_mcp-0.4.16-py3-none-any.whl
Size	29.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`059fe4b32e12f48609752a5986f0d0552cef36fc4311113f85372e54f1770c68`
BLAKE2b-256 checksum How to use checksums	`a8c6b2363ad58d535c38ab4d3383d5eb3cab569684c4b8460537af886c500064`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`