VFB Model Context Protocol (MCP) Tool Guide

Learn how to use the VFB MCP tool to explore Virtual Fly Brain data through Large Language Models

Overview

The Virtual Fly Brain Model Context Protocol (MCP) Tool enables you to query VFB data through Large Language Models like Claude using natural language. This guide shows you how to get started and provides examples of common queries.

What is MCP?

The Model Context Protocol is a standard that allows LLMs to interact with external data sources and tools. The VFB MCP tool follows this standard, providing your LLM with access to VFB’s neuroanatomical databases, NBLAST similarity scores, and term information.

Accessing the Tool

The VFB MCP tool is available at: vfb3-mcp.virtualflybrain.org

To use it, you’ll need:

  • An LLM that supports MCP (e.g., Claude with MCP integration)
  • Basic familiarity with asking questions about neuroanatomy

Core Features

The tool provides access to three main capabilities:

1. Term Information Queries (get_term_info)

Retrieve detailed information about any VFB term using its VFB ID.

Example Query:

"What is the medulla? Please get the full definition and structure."

Returns:

  • Term definition and synonyms
  • Classification and type information
  • Anatomical relationships (part of, develops from, innervates, etc.)
  • Associated neurons and expression patterns
  • Related images and connectivity data

2. Term Search (search_terms)

Search for VFB terms using keywords and filters.

Example Query:

"Find neurons in the medulla"

Advanced Filtering Options:

  • Filter by entity type: neuron, muscle, glia, anatomical region
  • Filter by nervous system component: visual system, olfactory system, sensory neuron, motor neuron, etc.
  • Filter by nervous system property: cholinergic, GABAergic, glutamatergic, dopaminergic, peptidergic, etc.
  • Filter by dataset: FAFB, FlyCircuit, hemibrain, neuprint, flycircuit, etc.

3. Query Execution (run_query)

Execute specific queries on VFB terms, including NBLAST similarity analysis.

Example Query:

"What neurons are morphologically similar to IN02A049?"

Example Use Cases

Case 1: Exploring a Transgenic Construct

User Question: “What is P{E(spl)m8-HLH-2.61} and where is it used?”

Tool Actions:

  1. Search for the construct in VFB
  2. Retrieve full term information
  3. Return detailed description including:
    • FlyBase ID (FBtp0004163)
    • Gene involved: E(spl)m8
    • Type: Transgenic construct (reporter for gene expression)
    • Expression patterns and research use
    • Related constructs and variants

Result: You get comprehensive information about the transgenic reporter, its purpose, and research applications.

Case 2: Understanding a Neuroblast Population

User Question: “What is the Medulla Forming Neuroblast and what role does it play?”

Tool Actions:

  1. Search for “medulla forming neuroblast”
  2. Get term info for FBbt_00001938
  3. Return:
    • Cell type classification (neuroblast)
    • Location in the larval optic anlage
    • Developmental fate (produces medulla neurons)
    • Marker genes (dpn, ase)
    • Number of neurons produced (~54,000 secondary neurons)
    • Available scRNAseq and expression data

Result: Understand the neuroblast’s role in developing the adult medulla’s neural circuitry.

Case 3: Discovering Neuron Types

User Question: “What types of neurons are in the medulla?”

Tool Actions:

  1. Search for “neuron” with filter for medulla
  2. Return 472 neuron types with parts in the medulla, organized by category:
    • Medulla intrinsic neurons (Mi): columnar neurons with confined processes
    • Central medulla intrinsic neurons (Cm): arborizing in central/serpentine layer
    • Medulla tangential neurons (Mt): wide-field spanning neurons
    • Medulla visual projection neurons (MeVP): tangential projection neurons
    • Medulla columnar neurons (MC): connecting medulla to tubercle
    • Plus many more specialized types

Result: Get a comprehensive overview of medulla neuron diversity and organization.

Case 4: Morphological Similarity Queries

User Question: “Show me what the IN02A049 neuron looks like and find similar neurons.”

Tool Actions:

  1. Get term info for IN02A049 (specific instance from MANC connectome)
  2. Execute NBLAST query for morphologically similar neurons
  3. Return:
    • 3D visualization of the neuron
    • Classification and properties
    • Synaptic inputs (neurotransmitter types and counts)
    • Morphologically similar neurons with NBLAST scores
    • Cross-connectome comparisons

Result: Discover morphologically similar neurons for comparative analysis.

Case 5: Understanding NBLAST Scores

User Question: “How are NBLAST scores calculated?”

Tool Actions:

  1. Search for “NBLAST”
  2. Return detailed explanation including:
    • Algorithm basis (Costa et al. 2016)
    • How neurons are represented (point skeletons with direction vectors)
    • Scoring mechanism (Euclidean distance + direction similarity)
    • Normalization approach (comparison to self-match)
    • Asymmetry property and symmetrical variants
    • Available datasets (FAFB-FlyWire, Male-CNS optic lobe, FlyCircuit, Hemibrain, FAFB-CATMAID)

Result: Understand the methodology behind VFB’s morphological similarity analysis.

Tips for Effective Queries

1. Use VFB IDs When Known

If you know the VFB ID of a term, use it directly:

"Get me detailed information about FBbt_00003748 (the medulla)"

2. Combine Search and Query

Use search first to find relevant terms, then query them:

"Find all cholinergic neurons in the visual system, 
then tell me about the top 5"

3. Filter Strategically

Use filters to narrow results:

"Show me motor neurons from the male-CNS optic lobe dataset"

4. Explore Relationships

Ask about anatomical and functional relationships:

"What neurons innervate the medulla? 
What brain regions do they come from?"

5. Cross-Dataset Comparisons

Compare neurons across different connectome datasets:

"Find the equivalent of this FAFB neuron in the hemibrain dataset"

Available Datasets

The VFB MCP tool provides access to neurons and data from:

  • FAFB-FlyWire (v783) - Large-scale adult brain connectome
  • Male-CNS optic lobe (v1.0.1) - Focused optic lobe connectome
  • FlyCircuit (1.0) - Single-neuron morphology database
  • Hemibrain (1.2.1) - Subset of adult brain connectome
  • FAFB-CATMAID - Manually traced EM data
  • FlyLight Split-GAL4 - Driver line expression images
  • scRNAseq data - Transcriptomic information

Understanding VFB IDs

VFB terms use standardized identifiers:

  • FBbt_ - Drosophila anatomy terms (e.g., FBbt_00003748 = medulla)
  • FBgn_ - FlyBase genes (e.g., FBgn0000137 = ase gene)
  • FBtp_ - FlyBase transgenic constructs (e.g., FBtp0004163 = P{E(spl)m8-HLH-2.61})
  • VFB_ - VirtualFlyBrain-specific IDs for individuals and images

Next Steps

Common Questions

Q: Do I need to install anything? A: No, if you’re using Claude or another MCP-compatible LLM with the integration already set up, just start asking questions.

Q: Can I download the data I find? A: Yes, many results include links to download images, neuron skeletons, and connectivity data. Check the API documentation for programmatic access.

Q: What if I don’t know the VFB ID? A: The search tool can find terms by name or keyword. The LLM will help you locate the right term.

Q: Can I combine VFB queries with other analyses? A: Absolutely! You can ask your LLM to retrieve VFB data and then perform additional analyses, create visualizations, or integrate with other tools.

Happy exploring! If you have questions or suggestions about the VFB MCP tool, please reach out to the VFB team.


Last modified February 7, 2026: feat: add VFB Model Context Protocol (MCP) Tool and guide documentation (e974091)