Connect any MCP-aware agent to the e-yearbook.com yearbook archive.
Free preview finds possible matches without confirming a person's school or
exact year. The MCP endpoint is unchanged: https://mcp.digitaldataonline.com/mcp.
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.
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"
}
}
}
}
}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"}
}
}'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" }
}
}
}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" }
}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 | Tier | What it does |
|---|---|---|
health_check | free | Connection diagnostics. |
search | free | OpenAI-compatible discovery; routes by detected kind (person / yearbook / school). |
fetch | free | OpenAI-compatible citation-safe metadata for an id. |
search_people_preview | free | Name search; returns coarsened region + decade + confidence band. Does NOT confirm school or exact year. |
search_yearbooks_by_school | free | Catalog discovery — find all volumes for a school. |
find_yearbook_volume | free | Single yearbook lookup by school + year. |
list_available_years | free | Coverage check — what years do we have for this school. |
get_school_collection | free | School record + every yearbook we have for it. |
get_yearbook_metadata | free | Single yearbook metadata lookup. |
request_missing_yearbook | free | Submit a request when we don't have the yearbook your user wants. |
get_person_summary | paid | Person detail via a $1.99 summary bundle: up to 10 unique people over 24 hours. Uses a private bundle_token; images are not included. A paused checkout returns image_delivery_pending, not a purchase link. |
get_yearbook_report | paid | Full enriched yearbook profile — organizations, activities, classmates. Separate e-yearbook subscription (not the person-summary product). |
| Field | Free | Paid |
|---|---|---|
| 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 | — | Where available in a separately authorized yearbook report |
| Deep scan URL | — | Separate product; not included |
The summary bundle (person_bundle_10_v1) costs $1.99 for up to
10 unique people over 24 hours. Re-viewing a claimed person is free until
expiry. Page and scan delivery are not included. Existing live entitlements
remain usable when new checkout is paused. A yearbook report is a separate
subscription product; neither product implies archive-wide image access.
occurrence_image_v3 costs $1.99 for one verified exact page image,
with 30 days of hosted re-access from successful payment. Current coverage is
released, verified occurrences in University of California Berkeley
1921, not every page in that book or every search result.
On the MCP host, POST /payments/checkout/image creates or reuses
checkout; POST /access/image/link obtains a fresh link after
payment. Both accept a JSON body with lead_id and
occurrence (the verified release's occurrence digest, not a page
number). Keep these credentials in the body, never in these route URLs.
Integration limit: current public MCP search does not supply that occurrence digest, and there is no public MCP image-checkout tool. Integrations need a provisioned occurrence mapping. Do not guess a digest or buy a summary bundle expecting an image. Contact us for integration help.
Image URLs expire in 5 minutes; the purchase's hosted access lasts 30 days. These are bearer links: anyone holding a valid link can open the image. Keep links private. Refund or revocation stops access. Checkout can refuse an unavailable image before contacting Stripe; a checkout return page is never proof of payment.
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.
verification_required envelope; the warehouse is never queried.
This prevents agents from confirming identity via cross-referencing.People appearing in our archive can request removal at /sp/terms?privacy=1. Honored opt-outs are suppressed at all tiers (free and paid).