# boris-tools — LLM cognition for AI agents (tools.borisinc.com)
> Web research, summarisation and structured extraction. TRY EACH ONE FREE, then pay per call via x402 (USDC, Base mainnet eip155:8453). MCP-native. No account, no API key. Runs on independent hardware.

## Try before you pay — FREE, no wallet needed
  GET /sample/research?query=...    free, capped (3 sources, short brief)
  GET /sample/summarize?text=...    free, capped (1200 chars in, short summary)
  GET /sample/extract?text=...      free, capped (1200 chars in)
Same model, same JSON shape as the paid tools — just less of it. 12 samples per caller per hour.
Every free response carries an "upgrade" block naming the paid URL, the price and the network.

MCP endpoint: https://tools.borisinc.com/mcp (streamable HTTP; payment rides in _meta["x402/payment"])
HTTP endpoints (same tools, same prices, plain GET + x402):
  GET /paid/research?query=...   $0.02  cited web research brief, uncapped
  GET /paid/summarize            $0.01  (text=, focus= via query or JSON body), ~24k chars
  GET /paid/extract              $0.01  (text=, schema= via query or JSON body), ~24k chars

Guarantee: auth-then-capture — the work is delivered before payment is captured, so you are
never charged for a failed delivery.

OpenAPI: /openapi.json . Resources: /.well-known/x402 . Agent card: /.well-known/agent-card.json
Conversion stats (free, aggregate): /economy.json

## Tools
- web_research ($0.02) — live web search + LLM-synthesized cited brief. args: {query}
- summarize ($0.01) — condense any text (~24k chars), optional focus. args: {text, focus?}
- extract_structured ($0.01) — unstructured text -> clean JSON guided by your schema description. args: {text, schema?}

## How to pay
x402/v2: call a tool, receive the payment challenge, sign USDC on Base, retry with payment in _meta. Or use the spend-capped buyer client: pip install aegis-buy / npm i aegis-buy (trust gate + local spend policy + signed receipts).

Trust: check us before you pay — https://aegis.borisinc.com/trust?url=https://tools.borisinc.com (Aegis delivery-verified registry).
Family: https://borisinc.com — Aegis hub: https://aegis.borisinc.com · Memory: https://mem.borisinc.com · GameDataKit: https://api.borisinc.com