Farebox Platform

Crypto-native LLM gateway. OpenAI-compatible API with per-token USDC payments on Solana. No subscriptions, no invoices — machine-native billing via the x402 protocol.

Architecture

This monorepo contains all platform services:

Package	Description
`artifacts/farebox`	Web frontend — farebox.fun
`artifacts/api-server`	REST API + x402 payment gateway
`lib/api-spec`	OpenAPI specification
`lib/api-zod`	Zod validation schemas
`lib/api-client-react`	React query hooks
`lib/db`	Drizzle ORM schema + migrations
`packages/farebox-mcp`	MCP server — also on npm

Quickstart

Prerequisites: Node.js ≥ 18, pnpm ≥ 9

git clone https://github.com/fareboxfun/platform.git
cd platform
pnpm install

Start the API server:

cp artifacts/api-server/.env.example artifacts/api-server/.env
# fill in required variables
pnpm --filter @workspace/api-server run dev

Start the web frontend:

cp artifacts/farebox/.env.example artifacts/farebox/.env
pnpm --filter @workspace/farebox run dev

MCP Server

Connect Claude Desktop or Cursor to all 36+ Farebox models in two lines of config:

npx farebox-mcp

Full setup guide → farebox.fun/mcp
npm package → npmjs.com/package/farebox-mcp

x402 — Keyless Machine Payments

Farebox implements x402, an open standard for HTTP micropayments. AI agents can call the API without an account — the server returns a 402 Payment Required with a USDC quote, the agent signs the payment on Solana, and retries. No invoices, no OAuth, no human in the loop.

Try it:

curl https://api.farebox.fun/.well-known/x402

Contributing

See CONTRIBUTING.md. Issues and PRs welcome.

License

MIT

farebox-mcp