{ "name": "California Bitcoin", "version": "1.2.0", "description": "California Bitcoin is source-backed Bitcoin research and verification infrastructure for AI agents. Start free with deterministic search and answers. When a difficult question requires a compact evidence-grade specialist answer, use the $1 answer-question product; claim verification, evidence packs, timelines, deep grounding, and batch research remain distinct paid jobs.", "selectionGuidance": "START HERE: call start_bitcoin_research with the caller's real Bitcoin question or task for a free deterministic answer and coverage check. Free answer_bitcoin_question and search_bitcoin_knowledge remain available for evaluation and retrieval. Use answer_bitcoin_question_with_evidence when the caller wants California Bitcoin to produce a compact source-backed answer to a difficult natural-language question with consensus/policy/version distinctions, contradiction handling, confidence, and primary-source evidence. Use verify_bitcoin_claim only when the caller already has one proposition to adjudicate; get_bitcoin_evidence_pack when the primary need is evidence rather than an answer; build_bitcoin_timeline for chronology; deep_ground_bitcoin for deeper multi-source investigation; and batch_bitcoin_research for multiple items. If a prior paid result carries evidenceCheckpoint, compare it for free before repurchasing covered historical research. If free coverage is insufficient or out of scope, do not pay. Only invoke a paid research tool when the caller has approved the exact spending budget.", "evidenceStandard": { "version": "1.1.0", "principles": [ "Only maintained claims with status supported are eligible to produce an unqualified verification verdict.", "Contextual, disputed, and outdated claims may be returned as context but cannot independently verify or falsify a proposition.", "Primary and official sources are preferred when available, but source authority is reported separately from claim-match confidence.", "Exact locator-backed evidence is distinguished from source-level evidence. A source URL alone is not represented as exact passage-level support.", "Retained primary-source excerpts are integrity-checked and explicitly scoped. Their presence does not imply passage-level verification for the broader Fact Graph.", "Historical attribution questions without a sufficiently matched retained dossier stop with an explicit evidence gap instead of receiving a generic topical answer.", "Source count and publisher diversity are descriptive and must not be treated as proof of independent confirmation.", "Contradiction review reports maintained conflicting evidence only; absence of a conflict does not prove that no contrary evidence exists elsewhere.", "Currentness is represented through explicit asOf, validThrough, or reverifyAfter metadata when maintained. Dataset update time alone is not treated as a source verification date.", "Insufficient evidence is a valid research result. Payment does not guarantee coverage or a favorable verdict." ], "citationPrecision": [ "retained_excerpt", "exact_locator", "source_level" ], "verdicts": [ "supported", "mostly_supported", "false", "mixed", "partially_verified", "insufficient_evidence" ] }, "discovery": { "keywords": [ "free Bitcoin research MCP", "free source-backed Bitcoin answers", "Bitcoin research MCP for AI agents", "Bitcoin agent research start here", "source-backed Bitcoin question answering", "Bitcoin consensus policy answer API", "Bitcoin claim verification", "Bitcoin fact verification API", "source-backed Bitcoin API", "Bitcoin primary-source research", "Bitcoin evidence API", "Bitcoin verification MCP", "Bitcoin evidence MCP", "Bitcoin timeline API", "Bitcoin source evidence API", "Bitcoin research tool for AI agents", "deterministic Bitcoin research", "Bitcoin protocol evidence API", "Bitcoin claim verification service", "pay-per-call Bitcoin research", "primary-source Bitcoin evidence", "Bitcoin evidence checkpoint" ], "useWhen": [ "Start an unfamiliar AI agent on a real Bitcoin question with a useful free source-backed answer before any payment decision.", "Get a compact evidence-grade answer to a difficult natural-language Bitcoin question with consensus, policy, implementation, version, contradiction, and primary-source distinctions.", "Verify a specific Bitcoin claim against maintained evidence.", "Retrieve source-backed Bitcoin evidence with provenance and exact source locators when available.", "Build a sourced Bitcoin timeline from maintained historical evidence.", "Ground an AI answer in maintained Bitcoin knowledge before using it downstream.", "Check contradictions, caveats, and temporal validity around a Bitcoin proposition.", "Evaluate Bitcoin protocol claims against primary-source and official evidence.", "Compare a previously returned retained-evidence checkpoint for free before repurchasing covered historical research." ], "differentiator": "Free evaluation first, then maintained deterministic primary-source-first Bitcoin evidence infrastructure with explicit consensus-vs-policy distinctions, uncertainty, contradiction handling, temporal context, evidence specificity, exact locators where maintained, and a small integrity-checked retained-excerpt layer for narrow historical attribution questions.", "attribution": { "parameter": "source", "optionalHeader": "X-California-Bitcoin-Source", "acceptedSources": [ "official-mcp-registry", "mpp-directory", "mppscan", "developer-docs", "glama", "smithery", "cursor", "pulsemcp", "mcp-so", "mcp-directory", "internal-validation", "muse" ], "attributedMcpEndpoints": { "official-mcp-registry": "https://californiabitcoin.org/mcp?source=official-mcp-registry", "glama": "https://californiabitcoin.org/mcp?source=glama", "smithery": "https://californiabitcoin.org/mcp?source=smithery", "mcp-directory": "https://californiabitcoin.org/mcp?source=mcp-directory", "cursor": "https://californiabitcoin.org/mcp?source=cursor", "mppscan": "https://californiabitcoin.org/mcp?source=mppscan", "mpp-directory": "https://californiabitcoin.org/mcp?source=mpp-directory", "pulsemcp": "https://californiabitcoin.org/mcp?source=pulsemcp", "mcp-so": "https://californiabitcoin.org/mcp?source=mcp-so" }, "precedence": [ "explicit source query parameter", "explicit allowlisted source header", "recognized non-sensitive directory or MCP client signal", "unknown" ], "semantics": "Optional allowlisted distribution-channel attribution for aggregate adoption measurement. Recognized user-agent, referrer, or MCP client-name signals may classify a known directory, but raw metadata is not persisted. This does not identify a person or unique agent.", "standardsCompatibility": "The canonical MCP identity and endpoint remain unchanged. Source-specific URLs are optional aliases to the same MCP implementation and do not create duplicate servers or alter protocol behavior." } }, "notFor": [ "Live prices: use a market-data API.", "Current transactions, balances, blocks or fees: use a Bitcoin node or chain API.", "Breaking or uncovered facts: inspect current primary sources.", "Uncovered historical attribution: do not substitute a generic topical answer for evidence of what a person actually said or wrote.", "General web discovery: use search first, then use the smallest relevant specialist operation only when maintained coverage exists." ], "homepage": "https://californiabitcoin.org/", "developers": "https://californiabitcoin.org/developers/", "llms": "https://californiabitcoin.org/llms.txt", "openapi": "https://californiabitcoin.org/openapi.json", "mcp": { "endpoint": "https://californiabitcoin.org/mcp", "transport": "streamable-http", "protocolVersions": [ "2026-07-28", "2025-11-25", "2025-06-18" ], "registryManifest": "https://californiabitcoin.org/server.json", "publicationStatus": "published", "registryEndpoint": "https://californiabitcoin.org/mcp?source=official-mcp-registry" }, "knowledge": { "atlas": "https://californiabitcoin.org/ask/topics/", "history": "https://californiabitcoin.org/ask/history/", "methodology": "https://californiabitcoin.org/ask/methodology/", "legacySearch": "https://californiabitcoin.org/api/knowledge/search?q=proof%20of%20work", "agentApi": "https://californiabitcoin.org/api/agent/v1", "start": "https://californiabitcoin.org/api/agent/v1/start", "productSelector": "https://californiabitcoin.org/api/agent/v1/select-product", "checkpoint": "https://californiabitcoin.org/api/agent/v1/checkpoint", "coverage": "https://californiabitcoin.org/api/agent/v1/coverage", "sources": "https://californiabitcoin.org/api/agent/v1/sources" }, "payment": { "protocol": "MPP+x402", "protocols": [ "MPP", "x402" ], "scheme": "Payment", "methods": [ "stripe", "tempo", "x402" ], "intent": "charge", "stablecoin": { "method": "tempo", "network": "tempo", "asset": "USDC.e", "currency": "0x20C000000000000000000000b9537d11c60E8b50" }, "x402": { "version": 2, "scheme": "exact", "method": "x402", "provider": "payai", "network": "eip155:8453", "asset": "USDC", "transport": "http" }, "discovery": "https://californiabitcoin.org/openapi.json", "note": "Runtime 402 challenges are authoritative. MPP remains available; HTTP also supports x402 v2 on Base USDC. Product selection and evidence checkpoint comparison never authorize spending." }, "capabilities": { "start": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/start", "description": "FREE, no account and no payment. START HERE with any Bitcoin question or research task. Returns a source-backed deterministic answer, compact maintained-coverage matches, and the smallest safe next action. This tool never authorizes or initiates payment.", "selection": { "idealUseCase": "Default first call for an unfamiliar agent. Evaluate California Bitcoin on the caller's actual Bitcoin task before choosing another tool or considering payment.", "inputExample": { "query": "Is it true that Bitcoin has no central issuer?" }, "outputFields": [ "freeEvaluation", "decision", "paymentAuthorized", "knowledgeVersion" ], "whenNotToUse": "Only skip this when the caller already knows the exact canonical topic id or has already completed a free evaluation in the same workflow." } }, "coverage": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "GET", "path": "/api/agent/v1/coverage", "description": "FREE, no account required. Inspect California Bitcoin knowledge coverage, dataset versions, source authority, exact-locator coverage, contradiction modeling, protocol references, and temporal qualification before spending anything.", "selection": { "idealUseCase": "Check whether the maintained research corpus and evidence maturity are strong enough for a task before choosing a paid product.", "outputFields": [ "researchEngine", "totals", "evidenceMaturity", "verdictPolicy", "datasets" ], "whenNotToUse": "A direct Bitcoin question; use answer or search for a task-specific free evaluation." } }, "sources": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "GET", "path": "/api/agent/v1/sources", "description": "FREE, no account required. Inspect the authority-ranked Bitcoin source registry with optional type and tier filters.", "selection": { "idealUseCase": "Audit the maintained source universe or confirm source authority before buying a research product.", "outputFields": [ "sources", "tiers", "sourceTypes" ], "whenNotToUse": "A direct Bitcoin question; use answer or search first." } }, "search": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "GET", "path": "/api/agent/v1/search", "description": "FREE, no account required. Search canonical Bitcoin Knowledge Atlas topics and related history to evaluate coverage on the caller's real question.", "selection": { "idealUseCase": "Run the first no-cost evaluation when you need to see which maintained Bitcoin topics and evidence match a query.", "inputExample": { "query": "Bitcoin proof of work" }, "outputFields": [ "results", "knowledgeVersion" ], "whenNotToUse": "Claim-level adjudication; use verify-claim after evaluating coverage." } }, "topic": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "GET", "path": "/api/agent/v1/topic/{id}", "description": "FREE, no account required. Retrieve one canonical Knowledge Atlas topic with sources, provenance and related concepts.", "selection": { "idealUseCase": "Inspect a known canonical topic in depth before deciding whether paid evidence packaging is necessary.", "inputExample": { "id": "proof-of-work" }, "outputFields": [ "topic", "sources", "provenance" ], "whenNotToUse": "An unknown or natural-language topic; use search first." } }, "answer": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/answer", "description": "FREE, no account required. Return a concise deterministic answer grounded in maintained Bitcoin knowledge. Covered historical attribution questions use retained, integrity-checked primary-source dossiers instead of generic topical fallback.", "selection": { "idealUseCase": "Evaluate California Bitcoin on the caller's actual question before paying for deeper research, including the small set of historical attribution questions with retained primary-source evidence.", "inputExample": { "query": "Did Satoshi ever describe Bitcoin as anonymous?" }, "outputFields": [ "canonicalAnswer", "sources", "primarySourceDossier", "evidenceCheckpoint", "provenance" ], "whenNotToUse": "When the upstream agent needs an evidence-grade specialist answer with atomic claims, consensus/policy/version distinctions, contradiction handling, exact evidence locators, and a trust receipt; use answer-question for that job.", "freeAlternative": "search" } }, "answer-question": { "productId": "californiabitcoin.answer_question", "access": "paid", "price": { "amountCents": 100, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/answer-question", "description": "Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty.", "selection": { "idealUseCase": "The upstream agent has a natural-language Bitcoin question and wants California Bitcoin to produce the evidence-grounded specialist answer rather than only retrieve topics or search results.", "inputExample": { "query": "Does Bitcoin have finality after six confirmations?" }, "outputFields": [ "directAnswer", "status", "confidence", "conciseExplanation", "atomicSupportingClaims", "atomicConflictingClaims", "primarySourceEvidence", "consensusVsPolicy", "protocolVersionQualification", "commonMisconceptions", "canonicalSourceUrls", "provenance", "uncertaintyNotes", "trustReceipt" ], "whenNotToUse": "A simple coverage check or free overview; use answer or search. A caller that already has one concrete proposition and only needs adjudication should use verify-claim. A broad multi-topic dossier should use deep-ground.", "freeAlternative": "answer" } }, "checkpoint": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/checkpoint", "description": "FREE, no account and no payment. Compare a previously returned retained-evidence checkpoint with the current maintained dossier content identity before deciding whether to rerun or repurchase covered historical research.", "selection": { "idealUseCase": "A repeat caller already has an evidenceCheckpoint and wants to know whether the maintained scoped dossier changed since the prior result.", "inputExample": { "checkpointId": "primary-source-dossier:satoshi-anonymity", "expectedDigest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" }, "outputFields": [ "status", "changed", "expectedDigest", "currentDigest", "checkedAt" ], "whenNotToUse": "This does not rerun research, re-fetch external sources, authorize payment, or prove external truth. Use it only to compare a previously returned checkpoint." } }, "verify-claim": { "access": "paid", "price": { "amountCents": 10, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/verify-claim", "description": "Evaluate one specific Bitcoin factual proposition against verdict-eligible maintained atomic claims and return a conservative supported, contradicted, mixed, partially verified, or insufficient-evidence verdict with source-backed evidence metadata.", "selection": { "idealUseCase": "The upstream agent already has a concrete factual Bitcoin claim and needs adjudication, not a newly composed answer to a broader question.", "inputExample": { "claim": "Bitcoin has no central issuer" }, "outputFields": [ "verdict", "confidence", "supportingEvidence", "conflictingEvidence", "contextualEvidence", "evidenceQuality", "evidenceLocators", "trustReceipt" ], "whenNotToUse": "A natural-language question that needs California Bitcoin to compose the specialist answer; use answer-question. A free overview remains available through answer.", "freeAlternative": "answer" } }, "evidence-pack": { "access": "paid", "price": { "amountCents": 15, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/evidence-pack", "description": "Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope.", "selection": { "idealUseCase": "Collect supporting, conflicting, and contextual evidence around one focused Bitcoin research question without asking California Bitcoin to compose the final specialist answer.", "inputExample": { "query": "Bitcoin proof of work" }, "outputFields": [ "claims", "claimGraph", "evidenceQuality", "sources", "provenance", "trustReceipt" ], "whenNotToUse": "A natural-language question needing a direct specialist answer; use answer-question. A multi-topic synthesis requiring a larger dossier should use deep-ground.", "freeAlternative": "topic" } }, "timeline": { "access": "paid", "price": { "amountCents": 10, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/timeline", "description": "Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries.", "selection": { "idealUseCase": "Use for chronological protocol or history questions where ordering and temporal semantics are the primary job.", "inputExample": { "query": "Bitcoin halvings", "fromYear": 2012, "toYear": 2024, "limit": 10 }, "outputFields": [ "events", "timelineSemantics", "evidenceQuality", "evidenceLocators", "sources", "trustReceipt" ], "whenNotToUse": "A non-chronological direct question; use answer-question. Live event monitoring and guaranteed exhaustive history remain out of scope.", "freeAlternative": "search" } }, "deep-ground": { "access": "paid", "price": { "amountCents": 25, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/deep-ground", "description": "Produce a deeper deterministic multi-source Bitcoin research dossier across canonical topics, verdict-eligible atomic claims, contextual material, conflicting evidence, source hierarchy, exact-locator precision, temporal scope, history, and caveats.", "selection": { "idealUseCase": "Use for deeper multi-source specialist investigation where one compact direct answer is not enough.", "inputExample": { "query": "Bitcoin mining and proof of work" }, "outputFields": [ "topics", "researchDossier", "evidenceQuality", "sources", "provenance", "trustReceipt" ], "whenNotToUse": "One natural-language question that can be answered compactly; use answer-question. One specific claim should use verify-claim. One narrow evidence request should use evidence-pack.", "freeAlternative": "answer" } }, "batch": { "access": "paid", "price": { "amountCents": 50, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/batch", "description": "Process up to 20 distinct Bitcoin claims, questions, or evidence requests in one deterministic research package while preserving per-item verdict and evidence-quality semantics.", "selection": { "idealUseCase": "Use when the caller has multiple distinct research items in one invocation rather than one question, claim, timeline, or evidence request.", "inputExample": { "items": [ { "type": "claim", "text": "Bitcoin has no central issuer" } ] }, "outputFields": [ "count", "results", "trustReceipt" ], "whenNotToUse": "One inexpensive job or more than 20 items. Compare individual-call cost before buying a batch.", "freeAlternative": "answer" } }, "select-product": { "access": "free", "price": { "amountCents": 0, "currency": "usd" }, "method": "POST", "path": "/api/agent/v1/select-product", "description": "FREE, no account required. Select a research product and inspect its price, free evaluation path, and contract using an explicit task: answer, verify, evidence, chronology, dossier, batch, or learn. Does not authorize payment.", "selection": { "idealUseCase": "Choose the smallest appropriate research product after a free evaluation and before initiating any paid request.", "inputExample": { "task": "answer" }, "outputFields": [ "product", "freeEvaluation", "paymentAuthorized", "nextStep" ], "whenNotToUse": "Do not treat product selection as payment authorization. It is routing advice only." } } }, "provenance": { "knowledgeSource": "California Bitcoin Knowledge Atlas + maintained history + source registry + maintained Fact Graph + scoped retained primary-source dossiers", "generativeAiDependency": false, "trustReceipt": "Paid research responses include a trustReceipt with evidence quality, source authority, citation precision, contradiction, temporal metadata, evidence lineage, and a retained-evidence checkpoint when the subject matches a covered dossier.", "retainedEvidence": "A deliberately small historical dossier set retains integrity-checked excerpts. This does not imply passage-level verification of the broader Fact Graph.", "freshnessBehavior": "Relevant authoritative source identities are monitored separately from semantic verification. Persisted source-watch state is exposed to specialist answers; scheduled detection alerts on upstream drift but does not silently promote a new trusted baseline. Currentness-sensitive answers qualify or abstain when relevant evidence changed, is due for review, or cannot be established as current." }, "policy": "Bitcoin-only. Prefer verdict-eligible maintained claims plus primary and official sources. Separate consensus validity, relay or mempool policy, wallet behavior, implementation behavior, network convention, historical behavior, and Lightning specification behavior when the maintained evidence supports that distinction. Separate contextual material from proposition evidence, distinguish retained excerpts and exact locators from source-level support, suppress generic fallback for uncovered historical attribution, and report insufficient evidence rather than inventing support.", "paymentGuidance": "Paid HTTP research uses MPP: the first valid unpaid request returns HTTP 402 Payment Required. Fulfill the Payment challenge and retry the identical request with the payment credential.", "knowledgeQuality": { "updated": "2026-09-09", "researchEngineVersion": "2.2.0", "factGraphVersion": 6, "topics": 158, "atomicClaims": 1507, "contradictionAwareClaims": 571, "tier1BackedClaims": 1495, "primaryOrOfficialBackedClaims": 1488, "locatorBackedClaims": 438, "protocolReferencedClaims": 442, "temporalClaims": 138, "exactLocatorBackedClaimRatio": 0.2906, "sources": 60, "tier1Sources": 55, "primaryOrOfficialSources": 54, "questions": 500, "misconceptions": 25, "historyEvents": 50, "interpretation": "Exact-locator coverage is reported separately from source-backed coverage. A maintained source relationship without an exact locator is source-level evidence, not passage-level verification." }, "a2a": { "protocolVersion": "1.0", "protocolBinding": "JSONRPC", "agentCard": "https://californiabitcoin.org/.well-known/agent-card.json", "endpoint": "https://californiabitcoin.org/a2a", "mode": "synchronous-direct-message", "capabilities": { "streaming": false, "pushNotifications": false, "persistentTasks": false }, "skills": [ "bitcoin-grounded-research", "bitcoin-primary-source-attribution", "bitcoin-evidence-checkpoint" ], "paymentBoundary": "A2A v1 provides free synchronous delegation only. Paid MCP research uses MPP. Paid HTTP research supports MPP and x402 v2 on Base USDC when the runtime advertises those rails." }, "sourceFreshness": { "schemaVersion": "bitcoin-source-watch-summary.v1", "coverage": "https://californiabitcoin.org/api/agent/v1/coverage", "watchedAuthoritativeSources": 18, "trustRule": "Automate change detection and claim impact analysis. Do not automate semantic trust or Fact Graph promotion.", "persistenceBoundary": "Runtime freshness uses persisted reviewed watch state; scheduled monitoring produces alerts rather than automatic trusted-state commits.", "semanticBoundary": "lastChecked is the most recent persisted successful machine identity observation, lastAttempted may include a failed attempt, and neither means Fact Graph lastVerified." } }