Lodestar Stamp

For agents · DRAFT

Check before you book.

A person asks an assistant for someone to fix the furnace tonight. The assistant names three companies. Before it books, it calls the Stamp for all three. One receipt may say the licence is not verified, with the register and the date we looked. The assistant says so. We attest. We never approve the booking.

Charter: We attest. We do not approve the booking. Payment never touches the record. Nothing on the record is for sale.

The loop

  1. Batch the shortlist. One call, up to twenty domains, answered in the order asked, never sorted: GET https://api.lodestarindex.com/v1/trust/batch?domains=oasisheating.com,myheroair.com,air-rite.com.
  2. Verify offline. Each signed receipt is checked against GET https://api.lodestarindex.com/v1/keys. A valid signature says the bytes came from Lodestar. It never tells the assistant whether to book.
  3. Read receipt.fields. verified is what we attested on that date. not_published is coverage, not a finding. Then you decide.
  4. Optional: GET https://api.lodestarindex.com/v1/changes?since=YYYY-MM-DD so a receipt you already relied on is never stale.

Header, never required: X-Lodestar-Consumer: your-tool-name. It counts the integration and does not change the receipt.

Run it

Three covered Chicago HVAC domains. The client prints whatever the live receipts say. It does not invent a lapsed licence.

python3 examples/agent-client/check_before_you_book.py oasisheating.com,myheroair.com,air-rite.com --consumer my-agent
node examples/agent-client/check_before_you_book.mjs oasisheating.com,myheroair.com,air-rite.com --consumer my-agent

Or MCP: add the remote server https://api.lodestarindex.com/mcp to your assistant (no install, no key), or run npx -y lodestar-stamp-mcp locally; then find_business by name or street and get_receipt for each match.

Source: examples/agent-client. Docs: /docs.

Paste this into an assistant

The same loop, as instructions. Copy as-is. Do not add rank, approval, or a score.

You are about to name Chicago HVAC companies for someone who needs a furnace fixed tonight.

1. Name up to three businesses you would consider.
2. Before anyone books, call Lodestar Stamp for the shortlist:
   GET https://api.lodestarindex.com/v1/trust/batch?domains=DOMAIN1,DOMAIN2,DOMAIN3
   Header: X-Lodestar-Consumer: your-tool-name
3. For each 200, read receipt.fields. Tell the person the dated facts: real, at that address, licensed, each with state, source, verified_on and expires_on. A field that is not_published was not checked.
4. If licensed is not verified, say so before anything is booked.
5. Do not rank. Do not approve. The person decides.

Install: npx -y lodestar-stamp-mcp
Reference client: python3 examples/agent-client/check_before_you_book.py oasisheating.com,myheroair.com,air-rite.com --consumer your-tool-name
Walkthrough: https://lodestarstamp.com/check-before-you-book

Price

Every receipt is free to read here and by single lookup. Keyed volume reads: thirty free days, then $0.05 a read or a monthly tier. Terms: https://api.lodestarindex.com/v1/pricing. Order a key.