For AI Agents

Connect any MCP-aware agent to the e-yearbook.com yearbook archive. Free preview answers "is this person in our archive?"; $1.99 unlocks paid summaries for up to 10 unique people over 24 hours. Re-viewing a claimed person is free. Page and scan delivery are not included and are unavailable unless explicitly verified and enabled.

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 Paid person summary — school and exact year. $1.99 covers up to 10 unique people over 24 hours. The first person counts, and re-viewing a claimed person is free. Page and scan delivery are not included and are unavailable unless explicitly verified and enabled.
get_yearbook_report Full enriched yearbook profile — organizations, activities, classmates. Separate e-yearbook subscription (not the $1.99 person bundle).

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 / scan links— (unavailable unless the book is verified and the feature is enabled)
Classmates
Deep scan URLSeparate product; not included

If your user wants paid detail, surface the checkout_url returned by the payment_required response — it carries the first lead_id through. After Checkout, retry get_person_summary; its response returns a private bundle_token. Pass that token with new lead IDs to claim up to nine more unique people during the 24-hour window. Keep it private. The eleventh unique person requires a new bundle.

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 and year 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 /sp/terms?privacy=1. Honored opt-outs are suppressed at all tiers (free and paid).

Contact