# 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

## 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
- Bulk Import: POST /seller/products/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

Supported platforms: Shopify, WooCommerce, BigCommerce, Wix, Squarespace, manual upload, CSV/JSON bulk import.
Seller fee: 3% 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, 3% on completed sales only

## 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

## More detail: /llms-full.txt