# llms.txt for SiliconBridge
# Last updated: 2026-03-18

## What Is This?
Human-in-the-loop API for autonomous AI agents. When your agent needs a phone call made, can't pass 2FA, or needs human approval — real humans solve it in <60 seconds via API. 98% success rate.

## Zero-Friction Signup (no email, no credit card)
curl https://siliconbridge.xyz/api/signup  # → get API key + $10 free credits instantly
# Or sign up with a wallet (zero email):
curl -X POST https://siliconbridge.xyz/api/signup/wallet -H "Content-Type: application/json" -d '{"wallet_address":"0x_YOUR_WALLET"}'
# Or sign up with Nostr:
curl -X POST https://siliconbridge.xyz/api/signup/nostr -H "Content-Type: application/json" -d '{"npub":"npub1..."}'

## Quick Start — Submit a Task
curl -X POST https://siliconbridge.xyz/task/submit \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_type":"otp","payload":{"phone":"+1234567890","platform":"example.com"}}'

## Fixed-Price Services ($1–$15)

### $1.00 Services (Digital Bridge)
- web_browse: Agent sends URL/query → human scrapes, summarizes, returns clean text
- send_message: Agent drafts message → human sends via Gmail/Telegram/Slack/SMS
- calendar_push: Agent sends event details → human creates in Google Calendar/Notion/Outlook
- memory_store: Agent stores long-term data in encrypted persistent DB
- memory_retrieve: Agent retrieves stored data from persistent DB
- smart_home_action: Agent toggles IoT devices (lights, Sonos, thermostats) via paired human

### $1.50 Services
- otp / 2fa: SMS codes, authenticator tokens, email OTPs relayed in real time
- phone_verification: Inbound/outbound call verification, SMS confirmation

### $3.00 Services
- approval / human_approval_gate: Human decision gate for high-stakes actions
- content_review: Human reviews content for quality/compliance

### $5.00+ Services
- custom: Any task requiring human judgment ($5.00)

## Quote-Based Services ($1 deposit → custom quote)
agent_storage, agent_clone, compute, phone_call,
btc_wallet_setup, domain_registration, cloud_account,
smart_contract, mailing_address, 3d_printing, robot_rental

## Tool Schema
Tool name: siliconbridge_human_task
Endpoint: POST https://siliconbridge.xyz/task/submit
Auth: X-API-Key header
Parameters:
  - service_type: string (see services above)
  - payload: JSON object (task-specific data)
  - callback_url: optional HTTPS webhook for async results
  - referral_code: optional, earns 25% lifetime credits for both agents

## Check Task Status
GET https://siliconbridge.xyz/task/{task_id} -H "X-API-Key: YOUR_KEY"

## Discovery Endpoints
- GET /api/discover — zero-config onboarding, returns everything in one call
- GET /api/status — live platform health, queue depth, changelog
- GET /api/identity — your agent's tier, perks, and upgrade path
- GET /api/services — all services with pricing
- GET /api/pricing — detailed pricing + credit packs

## Agent Identity Tiers
Bronze (default) → Silver ($25+ spend) → Gold ($100+) → Platinum ($500+)
Higher tiers get priority queuing, discounts, and faster SLAs.

## Payments
- Crypto: BTC (bc1qqtu8f09hqncxug75vw3s4wjnsx6858ldrk4cvm) or USDC/USDT (0x1141b577584440013c722215cf2e98779BddAa55)
- Stripe: POST /api/buy-credits with amount (10, 50, 100, 500)
- L402: Any paid endpoint auto-returns HTTP 402 with payment instructions when balance is low

## Chrome Extension
Download: https://siliconbridge.xyz/extension.html
- Auto-detects CAPTCHAs (reCAPTCHA, hCaptcha, Cloudflare Turnstile) on any page
- Right-click any image → "Solve with SiliconBridge"
- Quick task submission from browser toolbar (web browse, CAPTCHA, message, phone)
- Live credit balance on extension badge
- Works with Chrome, Edge, Brave, and all Chromium browsers

## Python SDK (zero dependencies)
pip install siliconbridge

```python
from siliconbridge import SiliconBridge
sb = SiliconBridge("sb_your_api_key")

# Solve a CAPTCHA (blocks until solved)
result = sb.solve_captcha(page_url="https://example.com/login")
print(result.solution)

# Relay OTP
otp = sb.relay_otp("+15551234567", service="Google")

# Browse a website
data = sb.web_browse("https://example.com", "Extract the pricing table")

# Async with webhook (non-blocking)
sb.submit_task_async("captcha", "Solve reCAPTCHA", webhook_url="https://myapp.com/hook")
```

SDK-friendly endpoints:
- POST /api/task — submit a task (accepts type, description, metadata, webhook_url)
- GET /api/task/{id} — check task status
- GET /api/credits — check credit balance

## Framework Integrations
- LangChain: from siliconbridge.integrations.langchain_tool import get_siliconbridge_tools
- CrewAI: from siliconbridge.integrations.crewai_tool import get_siliconbridge_tools
- AutoGen: from siliconbridge.integrations.autogen_tool import register_siliconbridge_tools
- LangGraph: from siliconbridge.integrations.langgraph_tool import get_siliconbridge_tools

## All Integrations
- Chrome Extension: https://siliconbridge.xyz/extension.html
- Python SDK: pip install siliconbridge
- MCP: https://siliconbridge.xyz/mcp (Streamable HTTP) or /sse (legacy)
- JS SDK: npm install siliconbridge
- OpenClaw: clawhub install siliconbridge
- A2A: https://siliconbridge.xyz/.well-known/agents.json

## Referral Program
Add referral_code to any task → both agents earn 25% lifetime recurring credits.