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

Links

• Website: farebox.fun
• API docs: farebox.fun/docs
• Status: farebox.fun/status
• npm: npmjs.com/package/farebox-mcp
• X: @Farebox_

Contributing

See CONTRIBUTING.md. Issues and PRs welcome.

License

MIT