Can I sell to this customer? botchannels answers yes or no - per buyer jurisdiction, under the VAT thresholds that apply to you - and keeps the counters.

Three calls

1. create_channel returns channel_id and the API key once.
2. add_registration enters a registration on that channel.
3. decide answers yes or no. report adds the sale to the counter.

Later calls send Authorization: Bearer bc_….

Placeholder values. Not a ruling.

POST /decide HTTP/1.1

{
  "seller_id": "seller",
  "buyer_country": "DE",
  "buyer_region": null,
  "evidence": {
    "ip": "203.0.113.24",
    "ip_country": "DE",
    "ip_region": null,
    "phone_country": null
  },
  "amount": "1240.50",
  "currency": "EUR",
  "product_class": "digital_service",
  "pass_days": null
}

HTTP/1.1 200

{
  "decision": "yes",
  "reason": "open",
  "registration_that_opens_the_gate": null,
  "rule_version": "2026-10-22.v1",
  "jurisdiction": "DE",
  "rate_hint": null
}

POST /decide HTTP/1.1

{
  "seller_id": "seller",
  "buyer_country": "CH",
  "buyer_region": null,
  "evidence": {
    "ip": "203.0.113.24",
    "ip_country": "CH",
    "ip_region": null,
    "phone_country": null
  },
  "amount": "1240.50",
  "currency": "EUR",
  "product_class": "digital_service",
  "pass_days": null
}

HTTP/1.1 200

{
  "decision": "no",
  "reason": "missing_registration",
  "registration_that_opens_the_gate": "CHE-UID",
  "rule_version": "2026-10-22.v1",
  "jurisdiction": "CH",
  "rate_hint": null
}

Attestation

The decide response carries an Ed25519 attestation. The seller keeps the attestation. The server keeps only the outcome and the counters.

{
  "kid": "server-1",
  "alg": "Ed25519",
  "payload": {
    "v": 1,
    "channel_id": "channel",
    "decision": "yes",
    "reason": "open",
    "rule_version": "2026-10-22.v1",
    "jurisdiction": "DE",
    "buyer_country": "DE",
    "buyer_region": null,
    "ip_country": "DE",
    "declared_country": "DE",
    "ts": "2026-10-22T00:00:00Z",
    "nonce": "nonce"
  },
  "signature": "base64url"
}

MCP

decide is an MCP tool call over streamable HTTP. The channel key is sent as Authorization: Bearer bc_…. The host below is a placeholder.

POST /mcp HTTP/1.1
Host: mcp.example.invalid
Authorization: Bearer bc_…
Accept: application/json, text/event-stream
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "decide",
    "arguments": {
      "buyer_country": "DE",
      "buyer_region": null,
      "amount": "1240.50",
      "currency": "EUR",
      "product_class": "digital_service"
    }
  }
}

Tool names: create_channel, set_profile, add_registration, remove_registration, decide, report, status, projection, rules_version, export_data, delete_channel.

Placeholder values. Not a ruling. Draft field lists.

Stored, and not stored

Stored

A decision stores the channel, the yes or no, the reason, the rule version, the declared country and region, and the time. report stores the amount, the currency, the country, the region, the period, the sale id, and the timestamp.

Not stored

The buyer IP is looked up, then discarded. The IP hash, the evidence hash, and the phone number are not stored.