# smithsonian-mcp-server MCP server

Search 19.4M Smithsonian Open Access objects, get CC0 images, find cross-collection connections.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-smithsonian-mcp-server
- Repository: https://github.com/cyanheads/smithsonian-mcp-server

## Install
- Command: `npx -y @cyanheads/smithsonian-mcp-server`
- Endpoint: https://smithsonian.caseyjhand.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm @cyanheads/smithsonian-mcp-server v0.1.1
- Environment variable: SMITHSONIAN_API_KEY (required)
- Environment variable: MCP_LOG_LEVEL (default info)
- Package: Npm @cyanheads/smithsonian-mcp-server v0.1.1
- Environment variable: SMITHSONIAN_API_KEY (required)
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://smithsonian.caseyjhand.com/mcp

## Tools
- smithsonian_search (Search Smithsonian Collections) - Search across 19.4 million Smithsonian objects by text query and optional filters. Filters narrow by museum unit, object type, decade, culture, geographic place, media type, and online-only availability. Returns curated summaries (title, date, museum, thumbnail URL, CC0 flag) with the total match count. The record_id in each result is the identifier for smithsonian_get_object, smithsonian_find_related, and smithsonian_get_media. Endpoint: https://smithsonian.caseyjhand.com/mcp
- smithsonian_get_object (Get Smithsonian Object) - Fetch the full catalog record for a Smithsonian object by its record_id (from smithsonian_search results). Returns all available metadata: title, dates, materials, dimensions, provenance, exhibition history, credit line, accession identifiers, and a media summary. Call smithsonian_get_media for full image URLs. Use record_id values from smithsonian_search — do not manually construct IDs. Endpoint: https://smithsonian.caseyjhand.com/mcp
- smithsonian_get_media (Get Smithsonian Object Media) - Return all available CC0 images for a Smithsonian object at multiple resolutions. Only CC0 (open access) images are returned — throws Forbidden when an object has media but none of it is CC0. Each image entry includes thumbnail (~120px), screen-size (~800px), and high-resolution JPEG/TIFF URLs with pixel dimensions. Use smithsonian_search with filters.cc0_only to find CC0 objects before calling this tool. Endpoint: https://smithsonian.caseyjhand.com/mcp
- smithsonian_explore (Explore Smithsonian by Category) - Browse Smithsonian collections by category to answer "what does the Smithsonian have about X?" questions. Constructs and executes a category-constrained search, then returns an overview: total count, a curated set of sample objects, and a breakdown of which museums hold matching objects. Four browse modes: museum (by unit code or name), culture (by culture term), period (by decade), medium (by object type). Use as the entry point for open-ended research. Endpoint: https://smithsonian.caseyjhand.com/mcp
- smithsonian_find_related (Find Related Smithsonian Objects) - Discover objects across Smithsonian collections related to a given anchor object. Fetches the anchor object's metadata (culture, period, object type, maker names, topic terms), then fans out up to 4 parallel searches using different metadata signals as queries. Deduplicates against the anchor and merges results into a ranked list. Cross-museum discovery is the differentiator — an NASM aerospace anchor may surface related objects from NMNH, SAAM, and NMAH. Endpoint: https://smithsonian.caseyjhand.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.cyanheads
- Version: 0.1.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 31, 2026
- Source: https://registry.modelcontextprotocol.io