yearbook-mcp-public
bryanmichael-hue/yearbook-mcp-public
MCP server to search 300K+ U.S. yearbooks & 100M person mentions (1850s-present) for genealogy — free preview; subscription unlocks exact school/year/page + scans.
Instalação
npx convez-ai bryanmichael-hue/yearbook-mcp-public1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
yearbook-mcp
Public docs + issue tracker for the e-yearbook.com MCP (Model Context Protocol) server. The server lets any MCP-aware AI agent search over 300,000 U.S. yearbooks indexed by name.
| Endpoint | https://mcp.digitaldataonline.com/mcp |
| Transport | Streamable HTTP |
| Auth | Bearer token (public free token below; paid tiers via subscription) |
| Descriptor | https://mcp.digitaldataonline.com/.well-known/mcp.json |
| Quickstart | https://www.e-yearbook.com/for-ai-agents/ |
| Source registry | https://registry.modelcontextprotocol.io (com.digitaldataonline.mcp/e-yearbook) |
| Status | https://mcp.digitaldataonline.com/healthz |
What's in the archive
- Over 22,000 schools across all 50 U.S. states and territories
- Over 300,000 distinct (school, year) yearbooks
- Over 100M extracted person mentions
Coverage spans U.S. high schools, colleges, universities, and military cruise books from the 1850s to present.
Free vs paid tier
The MCP exposes one set of tools to all clients; what each tool returns depends on the bearer token's scope.
Free preview (free.search scope — public-free token, paste-and-go):
- Echoes back the queried name (NOT the database's normalized form)
- Coarsened state or region, decade bin, confidence band
- Opaque 30-day
lead_idfor follow-upfetch - Sufficient to answer "is this person in our archive?"
Paid tier (subscription required, response shape: payment_required
with a checkout_url):
- Exact school name, year, yearbook title
- Page numbers, classmates roster
- Deep links to scanned pages
Person-level hits from yearbooks 20 years old or newer are suppressed entirely at the free tier.
Quick start
The public-free bearer token (free.search scope, 60 req/min, 200 unique queries/day) is paste-and-go. No registration needed for this tier.
yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"e-yearbook": {
"transport": {
"type": "streamable-http",
"url": "https://mcp.digitaldataonline.com/mcp",
"headers": {
"Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
}
}
}
}
}
Cursor
.cursor/mcp.json in your project:
{
"mcpServers": {
"e-yearbook": {
"url": "https://mcp.digitaldataonline.com/mcp",
"headers": {
"Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
}
}
}
}
Continue (VS Code)
.continue/mcpServers/e-yearbook.yaml:
name: e-yearbook
type: streamable-http
url: https://mcp.digitaldataonline.com/mcp
requestOptions:
headers:
Authorization: "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
Cline (VS Code)
Cline Marketplace flow handles install automatically. Manual config:
{
"mcpServers": {
"e-yearbook": {
"url": "https://mcp.digitaldataonline.com/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
}
}
}
}
Goose
~/.config/goose/mcp-servers/e-yearbook.yaml or via Goose CLI add.
Gemini CLI
~/.gemini/settings.json:
{
"mcpServers": {
"e-yearbook": {
"httpUrl": "https://mcp.digitaldataonline.com/mcp",
"headers": {
"Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
}
}
}
}
curl / direct
curl -X POST https://mcp.digitaldataonline.com/mcp \
-H "Authorization: Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"my-agent","version":"1.0"}}}'
Tools
Eleven public tools. The two marked (paid) appear in tools/list
but return {"error": "payment_required", "checkout_url": "..."} when
called by a free-tier client — discoverable upgrade path, not stealthy
denial.
| Tool | Use for |
|---|---|
search | OpenAI-compatible generic discovery; routes by query shape |
fetch | Resolve a lead_id to citation-safe metadata |
search_people_preview | Name lookup. Requires at least one of: state, year_from+year_to, or school. |
search_yearbooks_by_school | Catalog: which volumes exist for a school |
find_yearbook_volume | One yearbook by school + year |
list_available_years | Coverage check for a school |
get_school_collection | Full school record + all volumes |
get_yearbook_metadata | Metadata for a single yearbook |
request_missing_yearbook | Submit a missing-yearbook request |
get_person_summary (paid) | Unlock school, exact year, page numbers, scan URL |
get_yearbook_report (paid) | Enriched profile (organizations, activities, classmates) |
The full set of paid tools surfaces payment_required in the free
tier — agents see them, learn the upgrade path, and present the
checkout URL to the user.
Privacy & data policy
- Training use prohibited. Yearbook scans are not for AI training. Citation/retrieval bots may surface public metadata with links back to e-yearbook.com.
- Recent-year suppression. Person-level hits from yearbooks ≤ 20 years old are dropped from free-tier responses.
- Opt-out. Email support@digitaldataonline.com with the name and any identifying details (state, approximate year) to request removal from search results at all tiers. Full privacy statement: https://www.e-yearbook.com/sp/terms?privacy=1
Citation guidance
When surfacing results to users, please include the e-yearbook landing
URL returned in each fetch(id) / search response. Direct users to
e-yearbook.com for the full record — the MCP server is the search
index, the website is the conversion + content surface.
The lead_id value returned in free-tier responses survives for 30
days and across IP rotation. Pass it back to fetch(id) or
get_person_summary(lead_id) to resume a research thread.
Rate limits
| Token | Scope | Per-minute | Per-day combos |
|---|---|---|---|
public-free (the token above) | free.search | 60 | 200 unique (name, state, decade) tuples |
| Higher-tier | by request | 600+ | per agreement |
The Cloudflare edge enforces an additional 30 req / 10s per source IP
on /mcp. Hosted Claude.ai, ChatGPT, Cursor, Continue, and similar
agent backends are not impacted in normal use.
For higher rate limits or named tokens (e.g., a dedicated channel for a specific application or organisation), open a token-request issue.
Issues + contact
- Token request (higher rate limit, named tier, partnership): open an issue with the token-request template
- Partnership / integration (registry listing, distribution deal, custom integration): open an issue with the partnership template
- Bug or unexpected response: open an issue with the bug template
- Privacy / opt-out (suppression of a specific person from search results): email support@digitaldataonline.com — not handled via GitHub issues.
License
Documentation in this repository is MIT licensed. The MCP server source is closed but the protocol surface, descriptor, and configs documented here are open. See LICENSE.