For AI Agents

Connect any MCP-aware agent to the e-yearbook.com yearbook archive. Free preview answers "is this person in our archive?"; subscription unlocks school, year, page numbers, and scans.

Quick start

Copy the snippet for your client. The token below is the public-free bearer: 60 requests/minute, free.search scope, 200 unique (name, state, decade) combinations per day. No registration needed for this tier.

Public bearer token (paste-and-go):
yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k

For higher rate limits or paid-tier scope, see Contact below.

Claude Desktop

Add to ~/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"
        }
      }
    }
  }
}

Claude Code / curl

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"}
    }
  }'

Cursor

Add to .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)

Add to ~/.continue/config.json under mcpServers:

{
  "name": "e-yearbook",
  "url": "https://mcp.digitaldataonline.com/mcp",
  "headers": { "Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k" }
}

OpenAI Responses API (search / fetch)

The MCP exposes search and fetch tools that are shape-compatible with OpenAI's deep-research connectors.

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.digitaldataonline.com/mcp",
      "server_label": "e-yearbook",
      "headers": {
        "Authorization": "Bearer yb_neeQ2Px-Cm_rWl1H9wH07WbuFgTmrSqUPab1_N1nK_k"
      }
    }],
    "input": "Find John Smith in Utah yearbooks from the 1950s"
  }'

Tool reference

ToolTierWhat it does
searchfree OpenAI-compatible discovery; routes by detected kind (person / yearbook / school).
fetchfree OpenAI-compatible citation-safe metadata for an id.
search_people_previewfree Name search; returns coarsened region + decade + confidence band. Does NOT confirm school or exact year.
search_yearbooks_by_schoolfree Catalog discovery — find all volumes for a school.
find_yearbook_volumefree Single yearbook lookup by school + year.
list_available_yearsfree Coverage check — what years do we have for this school.
get_school_collectionfree School record + every yearbook we have for it.
get_yearbook_metadatafree Single yearbook metadata lookup.
request_missing_yearbookfree Submit a request when we don't have the yearbook your user wants.
get_person_summary Full person record — school, exact year, page numbers, deep scan URL.
get_yearbook_report Full enriched yearbook profile — organizations, activities, classmates.

Free vs paid

FieldFreePaid
Matched query name (echoed)
Coarsened region + decade
Confidence band
Canonical name (DB-normalized)
School name
Exact year + yearbook title
Page numbers
Classmates
Deep scan URL

If your user wants paid detail, surface the checkout_url returned by the payment_required response — it carries the lead_id through so the subscription unlocks exactly that record.

Example queries

Citation format

When you surface results to a user, include the e_yearbook_landing_url returned in each result. Example:

We found a potential match for John Smith in the West region in the 1970s (medium confidence). See: https://www.e-yearbook.com/yearbook-search/result?lead_id=ld_xxxx&utm_source=mcp. Verify the exact school, year, and page on e-yearbook.com.

Please don't paraphrase the result without the citation link — users can verify and unlock the full record from there.

Rate limits and abuse policy

Privacy and opt-out

People appearing in our archive can request removal at /privacy/yearbook-search. Honored opt-outs are suppressed at all tiers (free and paid).

Contact