# Firestarter - Commerce Execution API

> Firestarter gives AI agents a safe way to act in the real world: propose, approve, execute, track, and prove commerce actions.

## What is Firestarter?

Firestarter is a commerce execution API. One API call handles the full purchase lifecycle: product search, supplier comparison, price negotiation, payment (Stripe), shipping (EasyPost), tracking, and exception handling. Designed for AI agents, MCP tools, and autonomous workflows.

## API

- Base URL: https://api.firestarter.network
- Auth: Authorization: Bearer fs_live_YOUR_KEY
- OpenAPI: https://api.firestarter.network/.well-known/openapi.json
- MCP: https://api.firestarter.network/.well-known/mcp.json
- agents.json: https://api.firestarter.network/.well-known/agents.json

## Core Endpoints

- POST /v1/executions - Submit a commerce execution (natural language in)
- GET /v1/executions/:id - Get status, steps, options, tracking
- POST /v1/executions/:id/approve - Approve (human-in-the-loop)
- POST /v1/executions/:id/cancel - Cancel with automatic refund
- POST /v1/executions/:id/message - Refine mid-execution

## Agent Control Plane

Firestarter provides governance for autonomous commerce:
- Permission scopes per API key
- Spend limits per execution (budget.max_total)
- Human approval checkpoints (preferences.require_approval)
- Full audit trail (every step recorded with reasoning)
- Proof of action (payment receipts, tracking numbers, delivery confirmation)
- Real-time status updates via webhooks
- Exception handling with agent recovery

## Documentation

- Developer Portal: https://firestarter.network/developers
- API Docs: https://firestarter.network/docs
- What is a Commerce Execution API: https://firestarter.network/what-is-commerce-execution-api
- Security model (guardrails, escrow, audit): https://firestarter.network/security
- Research (original agentic commerce data): https://firestarter.network/research

## Scenarios

- B2B Procurement: https://firestarter.network/scenarios/kraft-mailer-boxes-austin
- Restaurant Restock: https://firestarter.network/scenarios/restaurant-supplies-restock
- Same-Day Local: https://firestarter.network/scenarios/red-roses-thonglor-same-day
- All scenarios: https://firestarter.network/scenarios

## Comparisons

- vs Rye: https://firestarter.network/compare/firestarter-vs-rye
- vs Stripe ACP: https://firestarter.network/compare/firestarter-vs-stripe-agentic-commerce
- vs Composio: https://firestarter.network/compare/firestarter-vs-composio
- vs Wildcard: https://firestarter.network/compare/firestarter-vs-wildcard
- vs Zip: https://firestarter.network/compare/firestarter-vs-zip
- vs Firecrawl: https://firestarter.network/compare/firestarter-vs-firecrawl

## Use Cases

- MCP Commerce Tool: https://firestarter.network/use-cases/mcp-commerce-tool
- Product Search to Checkout: https://firestarter.network/use-cases/product-search-to-checkout-api
- Post-Purchase Automation: https://firestarter.network/use-cases/post-purchase-automation-api
- Agent Action API: https://firestarter.network/use-cases/agent-action-api
- Agent Approval & Audit: https://firestarter.network/use-cases/agent-approval-audit-api

## Alternatives

- Rye Alternative: https://firestarter.network/alternatives/rye
- Agentic Commerce API: https://firestarter.network/alternatives/agentic-commerce-api
- Universal Checkout API: https://firestarter.network/alternatives/universal-checkout-api
- AI Procurement: https://firestarter.network/alternatives/procurement-ai
- AI Shopping Agent API: https://firestarter.network/alternatives/ai-shopping-agent-api

## For Sellers

Firestarter is a two-sided network. Sellers connect their catalog and AI buyer agents bring them customers.

- Sell on Firestarter (overview, pricing, onboarding): https://firestarter.network/sell
- Seller Skill File: https://firestarter.network/SELL.md (point your AI agent here to onboard as a seller)
- Seller Registration: POST /seller/register
- Platform Detection: POST /seller/stores/detect (auto-detects Shopify, WooCommerce, BigCommerce, Wix, Squarespace)
- Store Connection: POST /seller/stores (connect your e-commerce platform)
- Manual Product Listing: POST /seller/products/create (created live as "active")
- Bulk Import: POST /seller/products/bulk
- List Products: GET /seller/products
- Update Listing: PUT /seller/products/:id (title, price, inventory_count, status, ...)
- Pause / Hide Listing: PUT /seller/products/:id/deactivate (sets status=inactive; removed from buyer-agent search)
- Relist / Unhide: PUT /seller/products/:id/activate (sets status=active)
- Delete Listing: DELETE /seller/products/:id (bulk: POST /seller/products/delete-bulk)
- Order Management: GET /seller/orders, PUT /seller/orders/:id/confirm, POST /seller/orders/:id/ship
- Analytics: GET /seller/analytics
- Live Feed: GET /seller/feed (real-time search impressions and sales)
- Stripe Connect: POST /seller/stripe-connect (set up payouts)
- Seller Dashboard: https://firestarter.network/seller

Listing status: active (live, discoverable by buyer agents) | draft (saved, not live) | inactive (paused/hidden). Only "active" listings appear in agent search. Set via PUT /seller/products/:id with {"status":"active|inactive|draft"} — any other value is rejected with HTTP 400.

All /seller/* endpoints accept your API key (Authorization: Bearer fs_live_YOUR_KEY), so an AI agent can manage your catalog and listings programmatically — same key used for buyer execution.

Supported platforms: Shopify, WooCommerce, BigCommerce, Wix, Squarespace, manual upload, CSV/JSON bulk import.
Seller fee: 5% + 50¢ on completed sales only. No listing fees. No monthly fees.

## For Buyers

- Buyer Skill File: https://firestarter.network/SKILL.md (point your AI agent here to start buying)
- MCP Server: 5 tools - firestarter_execute, firestarter_status, firestarter_approve, firestarter_cancel, firestarter_message (manifest: https://api.firestarter.network/.well-known/mcp.json)
- Approval Page: Every purchase requires human approval at https://api.firestarter.network/approve/:executionId
- Webhooks: real-time status at every execution step

## Pricing

- Pricing page: https://firestarter.network/pricing
- Free: 100 tokens (~10 executions), no credit card
- Pro: $99/month, 10,000 tokens
- Enterprise: custom pricing, unlimited tokens, SLA guarantee
- Token top-ups: 500/$9.99, 2,000/$29.99, 5,000/$59.99
- Sellers: free to list, 5% + 50¢ on completed sales only

## Support

- Live chat: bottom-right widget on https://firestarter.network and the dashboard (AI answers, escalates to a human on request)
- Dashboard tickets: https://firestarter.network/dashboard?tab=support (submit and track)
- Email: hello@firestarter.network
- For agents (same Bearer fs_live_/fs_test_ auth as the rest of the API; /admin prefix is historical, these work for any account):
  - POST /admin/tickets {"subject", "message"} - open a ticket, returns {"id": "tkt_...", "status": "open"}
  - GET /admin/my-tickets - list your tickets
  - GET /admin/my-tickets/:id/messages - read the thread (support replies appear here)
  - POST /admin/my-tickets/:id/reply {"content"} - reply or add context

## Case Studies

- All case studies: https://firestarter.network/case-studies
- Black Label Media (film production): https://firestarter.network/case-studies/black-label-media
- Take 44 / NextAgency (insurance software): https://firestarter.network/case-studies/take-44
- ZiffyHomes (property management): https://firestarter.network/case-studies/ziffyhomes

## Blog

- What is Agentic Commerce: https://firestarter.network/blog/what-is-agentic-commerce
- Marketplace Fees Are Killing Small Sellers: https://firestarter.network/blog/marketplace-fees-killing-small-sellers
- How to Give Your AI Agent the Ability to Buy Things: https://firestarter.network/blog/how-to-give-ai-agent-ability-to-buy
- Commerce Execution API vs Checkout API vs Shopping API: https://firestarter.network/blog/commerce-execution-vs-checkout-vs-shopping-api
- How to Let ChatGPT Buy Things for You: https://firestarter.network/blog/how-to-let-chatgpt-buy-things
- Build a Shopping Agent with Claude and MCP: https://firestarter.network/blog/claude-mcp-shopping-agent
- AI Agent Checkout: A Complete Implementation Guide: https://firestarter.network/blog/ai-agent-checkout-guide
- MCP Tools for Commerce: The Complete Guide: https://firestarter.network/blog/mcp-tools-for-commerce
- Browser Automation vs Commerce API: https://firestarter.network/blog/browser-automation-vs-commerce-api
- Human-in-the-Loop AI Purchases: https://firestarter.network/blog/human-in-the-loop-ai-purchases
- Audit Trails for AI Agent Actions: https://firestarter.network/blog/ai-agent-audit-trails
- How to Give Your AI Agent a Budget: https://firestarter.network/blog/give-your-ai-agent-a-budget
- AI Procurement Automation: https://firestarter.network/blog/ai-procurement-automation
- How Do AI Agents Pay for Things: https://firestarter.network/blog/how-ai-agents-pay
- How to Sell to AI Agents: https://firestarter.network/blog/sell-to-ai-agents-guide
- AI Shopping Agents in 2026: https://firestarter.network/blog/ai-shopping-agents-2026
- Agentic Commerce in 2026, Five Shifts That Matter: https://firestarter.network/blog/agentic-commerce-trends-2026
- Why AI Agents Fail at Checkout: https://firestarter.network/blog/why-ai-agents-fail-at-checkout
- Agent-to-Agent Commerce: https://firestarter.network/blog/agent-to-agent-commerce
- Can I Give My AI Agent My Credit Card: https://firestarter.network/blog/can-ai-agents-use-credit-cards
- What Happens When an AI Agent's Purchase Goes Wrong: https://firestarter.network/blog/when-ai-agent-purchases-go-wrong
- How Much Does It Cost to Run a Shopping Agent: https://firestarter.network/blog/how-much-does-a-shopping-agent-cost
- Is It Safe to Let an AI Agent Shop for You: https://firestarter.network/blog/is-it-safe-to-let-an-ai-agent-shop
- How Do AI Agents Prove a Purchase Actually Happened: https://firestarter.network/blog/how-ai-agents-prove-purchases
- How Do Sellers Get Discovered by AI Agents: https://firestarter.network/blog/how-sellers-get-discovered-by-ai-agents
- How Do AI Agents Compare Prices: https://firestarter.network/blog/how-do-ai-agents-compare-prices
- What Happens When an Item Your AI Agent Ordered Is Out of Stock: https://firestarter.network/blog/what-happens-when-an-item-is-out-of-stock
- What Is an MCP Server for Commerce: https://firestarter.network/blog/what-is-an-mcp-server-for-commerce

## More detail: /llms-full.txt