MCP Server for Girder

Connect an AI Agent or any MCP-compatible client to your Girder instance. Browse collections, folders, items and files; read and write metadata; upload files; search and filter — all from your agent.

MCP Endpoint

https://girder-mcp.xn--gatandesrues-2eb.fr/mcp

Client Setup (.mcp.json)

Drop this file at the root of your project and fill in your API key:

{
  "mcpServers": {
    "girder": {
      "type": "http",
      "url": "https://girder-mcp.xn--gatandesrues-2eb.fr/mcp",
      "headers": {
        "X-Girder-API-Key": "<API_KEY>"
      }
    }
  }
}

Generate a key in Girder: My Account → API Keys → Create key.

Available Tools

Tool	Description
Navigation
girder_whoami	Authenticated user info
girder_get_by_path	Resolve a path like `/collection/…/item` to a resource
girder_list_collections	Top-level collections
girder_list_folders	Folders inside a collection or folder
girder_get_folder	Folder details (name, parent, meta)
girder_list_items	Items inside a folder
girder_get_item	Item details and its files
girder_search	Full-text search across resources
Files
girder_list_files	Files attached to an item
girder_get_download_url	Download URL for a file
girder_read_text_file	Download and return a text/JSON/CSV file content inline
Metadata
girder_get_metadata	Read metadata of an item, folder, or collection
girder_find_items_by_metadata	Filter items in a folder by a metadata condition (eq, lt, gt, contains…)
girder_set_metadata	writeMerge metadata onto an item, folder, or collection
girder_delete_metadata	deleteRemove specific metadata keys from a resource
Create & Organize
girder_create_folder	writeCreate a folder in a collection or folder
girder_create_item	writeCreate an item (file container) in a folder
girder_upload_text_file	writeUpload a text/JSON/CSV string as a file on an item
girder_move_resource	writeMove an item or folder to a new parent