{"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.","selectionTasks":{"answer":"answer-question","verify":"verify-claim","evidence":"evidence-pack","chronology":"timeline","dossier":"deep-ground","batch":"batch","learn":"answer"},"products":[{"id":"start","productId":"start","purpose":"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.","access":"free","price":{"currency":"usd","amountCents":0},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/start","mcpTool":"start_bitcoin_research","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."},{"id":"coverage","productId":"coverage","purpose":"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.","access":"free","price":{"currency":"usd","amountCents":0},"method":"GET","endpoint":"https://californiabitcoin.org/api/agent/v1/coverage","mcpTool":null,"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."},{"id":"sources","productId":"sources","purpose":"FREE, no account required. Inspect the authority-ranked Bitcoin source registry with optional type and tier filters.","access":"free","price":{"currency":"usd","amountCents":0},"method":"GET","endpoint":"https://californiabitcoin.org/api/agent/v1/sources","mcpTool":null,"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."},{"id":"search","productId":"search","purpose":"FREE, no account required. Search canonical Bitcoin Knowledge Atlas topics and related history to evaluate coverage on the caller's real question.","access":"free","price":{"currency":"usd","amountCents":0},"method":"GET","endpoint":"https://californiabitcoin.org/api/agent/v1/search","mcpTool":"search_bitcoin_knowledge","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."},{"id":"topic","productId":"topic","purpose":"FREE, no account required. Retrieve one canonical Knowledge Atlas topic with sources, provenance and related concepts.","access":"free","price":{"currency":"usd","amountCents":0},"method":"GET","endpoint":"https://californiabitcoin.org/api/agent/v1/topic/{id}","mcpTool":"get_bitcoin_topic","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."},{"id":"answer","productId":"answer","purpose":"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.","access":"free","price":{"currency":"usd","amountCents":0},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/answer","mcpTool":"answer_bitcoin_question","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"},{"id":"answer-question","productId":"californiabitcoin.answer_question","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":100},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/answer-question","mcpTool":"answer_bitcoin_question_with_evidence","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"},{"id":"checkpoint","productId":"checkpoint","purpose":"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.","access":"free","price":{"currency":"usd","amountCents":0},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/checkpoint","mcpTool":"check_bitcoin_evidence_checkpoint","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."},{"id":"verify-claim","productId":"verify-claim","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":10},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/verify-claim","mcpTool":"verify_bitcoin_claim","idealUseCase":"The upstream agent already has a concrete factual Bitcoin claim and needs adjudication, not a newly composed answer to a broader question. This is proposition-level adjudication.","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"},{"id":"evidence-pack","productId":"evidence-pack","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":15},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/evidence-pack","mcpTool":"get_bitcoin_evidence_pack","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"},{"id":"timeline","productId":"timeline","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":10},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/timeline","mcpTool":"build_bitcoin_timeline","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"},{"id":"deep-ground","productId":"deep-ground","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":25},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/deep-ground","mcpTool":"deep_ground_bitcoin","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"},{"id":"batch","productId":"batch","purpose":"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.","access":"paid","price":{"currency":"usd","amountCents":50},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/batch","mcpTool":"batch_bitcoin_research","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"},{"id":"select-product","productId":"select-product","purpose":"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.","access":"free","price":{"currency":"usd","amountCents":0},"method":"POST","endpoint":"https://californiabitcoin.org/api/agent/v1/select-product","mcpTool":"select_bitcoin_research_product","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."}],"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."],"name":"California Bitcoin Agent Commerce","version":"1.2.0","status":"live","basePath":"/api/agent/v1","mcp":{"endpoint":"/mcp","protocolVersion":"2026-07-28","tools":{"start_bitcoin_research":"start","search_bitcoin_knowledge":"search","get_bitcoin_topic":"topic","answer_bitcoin_question":"answer","answer_bitcoin_question_with_evidence":"answer-question","check_bitcoin_evidence_checkpoint":"checkpoint","verify_bitcoin_claim":"verify-claim","get_bitcoin_evidence_pack":"evidence-pack","build_bitcoin_timeline":"timeline","deep_ground_bitcoin":"deep-ground","batch_bitcoin_research":"batch","select_bitcoin_research_product":"select-product"}},"payment":{"protocol":"MPP","protocols":["MPP","x402"],"method":"stripe","methods":["stripe","tempo","x402"],"intent":"charge","environment":"live"},"capabilities":{"start":{"access":"free","priceCents":0,"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","priceCents":0,"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","priceCents":0,"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","priceCents":0,"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","priceCents":0,"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","priceCents":0,"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","priceCents":100,"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","priceCents":0,"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","priceCents":10,"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","priceCents":15,"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","priceCents":10,"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","priceCents":25,"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","priceCents":50,"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","priceCents":0,"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."}}},"researchEngine":{"name":"California Bitcoin Research Engine","version":"2.2.0","factGraphVersion":6},"documentation":"https://californiabitcoin.org/developers/","openapi":"https://californiabitcoin.org/openapi.json"}