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 the complete typed schema, compact query paths, 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.

Call get_schema_context() for complete root fields, then request a dot-separated branch such as get_schema_context(path="Acquisition.data_streams", max_depth=1) when nested model fields are needed. Use detail="paths" for compact query paths or detail="example" for a synthetic example.

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 .

To refresh the bundled schema snapshot after updating the dev dependency:

uv run python scripts/generate_schema_tree_snapshot.py

Metadata

Release files for aind-data-mcp 0.4.20

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.20
File	Size	Uploaded
aind_data_mcp-0.4.20.tar.gz	63.9 kB	Sep 4, 2026	Details

Built distribution (wheel)

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

Total release size: 125.6 kB

Release files / aind_data_mcp-0.4.20.tar.gz

Download URL	aind_data_mcp-0.4.20.tar.gz
Size	63.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`9c3bf22bacd2b2af6c67bb5c1d591194035941f17f1b23641451c437e10587b7`
BLAKE2b-256 checksum How to use checksums	`8d48fe980f41f4c4c1396ae6525e102c4c262e14fdfb38c10ddd703323416957`
Upload date	Sep 4, 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.20-py3-none-any.whl

Download URL	aind_data_mcp-0.4.20-py3-none-any.whl
Size	61.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`98a4de473c80a24bca301db7588a4c2278da5190d31d449599d2326c966503ef`
BLAKE2b-256 checksum How to use checksums	`841c1cdf775d02689b0e56a75cadd25bae892c70d55f519326a6a794116854a6`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`