# smithsonian-mcp-server

Searches Smithsonian objects, retrieves metadata and CC0 media, and finds links across collections. Useful for research and content workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 751 installs · ★ 2 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/smithsonian-mcp-server
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/smithsonian-mcp-server

## What it 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.

## Requirements
- Remote server: `https://smithsonian-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add smithsonian-mcp-server --url https://smithsonian-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "smithsonian-mcp-server": {
            "url": "https://smithsonian-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "smithsonian-mcp-server": {
            "type": "http",
            "url": "https://smithsonian-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http smithsonian-mcp-server https://smithsonian-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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_id` returned by the search.

## Similar
- [nature-downloader](https://affpapa.org/en/nevibecode/skills/nature-downloader.md) — skill · 13400 installs
- [content-access](https://affpapa.org/en/nevibecode/skills/content-access.md) — skill · 201 installs
- [ncbi-pmc-skill](https://affpapa.org/en/nevibecode/skills/ncbi-pmc-skill.md) — skill · 15 installs
- [linkfox-zhihuiya-abstract-image](https://affpapa.org/en/nevibecode/skills/linkfox-zhihuiya-abstract-image.md) — skill · 389 installs
- [linkfox-zhihuiya-fulltext-image](https://affpapa.org/en/nevibecode/skills/linkfox-zhihuiya-fulltext-image.md) — skill · 389 installs
- [sounds](https://affpapa.org/en/nevibecode/mcp/sounds.md) — MCP server · ★ 9 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
