smithsonian-mcp-server — Claude Code MCP server: install
Searches Smithsonian objects, retrieves metadata and CC0 media, and finds links across collections. Useful for research and content workflows.
Apache-2.0 751 installs ★ 2 updated 2026-10-18
claude mcp add --transport http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.toolsWhat smithsonian-mcp-server does
This MCP server gives an agent access to the Smithsonian Open Access catalog. It can search objects with text and filters, retrieve an object by record_id, return available CC0 images, and locate related items across collections. The package exposes six tools: smithsonian_search, smithsonian_list_terms, smithsonian_get_object, smithsonian_get_media, smithsonian_explore, and smithsonian_find_related.
Use smithsonian_list_terms to resolve exact values for museum, culture, place, period, or topic filters before searching. A guessed filter value can produce an empty result. Media retrieval is limited to objects with CC0 media, and object IDs should come from search results.
What it helps with
- search Smithsonian objects by topic and filters
- retrieve catalog metadata for a
record_id - fetch available CC0 images
- resolve exact filter vocabulary
- find links across collections
Example prompts for the agent
- Search Smithsonian for objects about astronomy and group the results by museum.
- Resolve the exact culture term first, then search for objects using that filter.
- Retrieve the metadata and available CC0 images for the
record_idreturned by the search.
How to install smithsonian-mcp-server
Platform CLI: remote server
claude mcp add --transport http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add smithsonian-mcp-server --url https://smithsonian-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"smithsonian-mcp-server": {
"url": "https://smithsonian-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"smithsonian-mcp-server": {
"type": "http",
"url": "https://smithsonian-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about smithsonian-mcp-server
How do I install smithsonian-mcp-server in Claude Code?
Run claude mcp add --transport http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.tools.
What does smithsonian-mcp-server do?
It searches the Smithsonian Open Access catalog, returns object metadata and available CC0 images, and discovers relationships between collections.
Why can a filter search return no results?
Filters require exact catalog terms. Resolve the value with smithsonian_list_terms before using it in a search.