Skip to main content

AIND Data MCP Server

License Code Style semantic-release: angular 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 projections
  • aggregation_retrieval — Execute complex MongoDB aggregation pipelines
  • 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_top_level_nodes — Explore the top-level fields of the V2 metadata schema
  • get_additional_schema_help — Query-writing guidance for V2 aggregations
  • get_modality_types — List all available data modality names and abbreviations

Schema Examples (one tool per document type)

  • get_acquisition_example, get_data_description_example, get_instrument_example, get_procedures_example, get_subject_example, get_processing_example, get_model_example, get_quality_control_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 .

Metadata

Release files for aind-data-mcp 0.4.12

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.12
File Size Uploaded
aind_data_mcp-0.4.12.tar.gz 28.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aind-data-mcp 0.4.12
File Interpreter ABI Platform
aind_data_mcp-0.4.12-py3-none-any.whl Python 3 none any Details

Total release size: 55.7 kB

Release files / aind_data_mcp-0.4.12.tar.gz

Download URL aind_data_mcp-0.4.12.tar.gz
Size 28.4 kB
Tags Source
SHA-256 checksum
How to use checksums
d0a659fbde2da9bf734a4d0836bfef306a912553ab25337e3cc36dde88d20643
BLAKE2b-256 checksum
How to use checksums
9f9fdd50329b37955f0290ffa65e7bff4f6a9ef1a6458b6f84e7b2987fc3f8c6
Upload date
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.12-py3-none-any.whl

Download URL aind_data_mcp-0.4.12-py3-none-any.whl
Size 27.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
01928bc28977c5d39879e7c6b2604f177c784c8a56f4c6d722b19509cfe713e6
BLAKE2b-256 checksum
How to use checksums
edbd894456bf35d8fe83046208d5694360b7af905b23c947d46a1bc2da77c1be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

0.4.21

2 release files

0.4.13

2 release files

This release

0.4.12 This release

2 release files

0.4.11

2 release files

0.4.10

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page