Miss Minutes routes people through the TVA's Sacred Timeline. TheMinutes routes your AI agents through the best service — and handles the payment automatically.

The service router for AI agents on Tempo. Discover, compare, and route to 100+ services that accept MPP payment with a single router.fetch() call. No hardcoded endpoints. No manual price checking. Just the right service, at the right price, every time.

import { createRouter } from "@theminutes/sdk";

const router = createRouter({ apiKey: "tm_...", strategy: "cheapest" });
const result = await router.fetch("web-search", { query: "latest MPP news" });

AI agents need to call external services — web search, compute, data, AI models — and pay for them autonomously via MPP. Today that means:

• Manually browsing Tempo's directory to find providers
• Hardcoding endpoints that go stale when better options launch
• No visibility into whether you're paying too much or routing to a slow provider

TheMinutes solves all three. It's a DEX aggregator for AI service calls — it finds the best route so your agent doesn't have to.

Agent calls router.fetch("web-search", { query })
         ↓
TheMinutes queries 100+ registered MPP providers
         ↓
Ranks by strategy: cheapest / fastest / balanced
         ↓
Handles the full MPP 402 payment flow
         ↓
Returns result + routing metadata (_routing.providerId, cost, latency)

Every routed request adds a $0.001 take rate on top of the provider price — invisible to agents, meaningful at scale.

• Service Registry — Auto-seeded from Tempo's directory, updated every 15 min. Manual registration via API or dashboard.
• Smart Routing — Three strategies: cheapest, fastest, balanced. Per-request overrides supported.
• Constraints — maxPrice, whitelist, blacklist, minUptime filters applied before scoring.
• Preview Mode — GET /v1/route/preview returns ranked providers without executing.
• Fallback — Automatically retries the next-ranked provider on failure.
• MCP Server — Native Claude/Cursor integration. Six tools: list_services, get_price, preview_route, route_request, get_spend, get_wallet.
• Health Monitor — Active probing every 30s + passive latency from real requests. p50/p90/p99 per provider.
• Take Rate Wallet — Operator earnings accumulate and auto-settle to your Tempo wallet.

docker compose up -d   # PostgreSQL + Redis
bun install
bun run db:migrate

cp .env.example .env
# Fill in: DATABASE_URL, REDIS_URL, OPERATOR_WALLET_ADDRESS, TEMPO_PRIVATE_KEY

bun run dev   # API on :3000, Dashboard on :3001

curl -X POST http://localhost:3000/v1/keys \
  -H "Authorization: Bearer tm_..." \
  -d '{ "name": "my-agent" }'

bun add @theminutes/sdk

import { createRouter } from "@theminutes/sdk";

const router = createRouter({
  apiKey: "tm_...",
  strategy: "balanced",           // cheapest | fastest | balanced
  constraints: { maxPrice: 0.05 } // never pay more than $0.05/req
});

// Route and pay automatically
const result = await router.fetch("web-search", { query: "Tempo MPP" });
console.log(result.data);       // provider response
console.log(result._routing);   // { providerId, cost, takeRate, latencyMs, reason }

// Preview without executing
const ranked = await router.preview("web-search");
// [{ rank: 1, score: 0.94, reason: "Cheapest at $0.010/req", provider: {...} }, ...]

// List all providers in a category
const providers = await router.list("web-search");

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "theminutes": {
      "command": "bunx",
      "args": ["@theminutes/mcp"],
      "env": {
        "THEMINUTES_API_KEY": "tm_...",
        "THEMINUTES_STRATEGY": "cheapest"
      }
    }
  }
}

Tools: list_services · get_price · preview_route · route_request · get_spend · get_wallet

All endpoints require Authorization: Bearer <api-key>.

┌─────────────────────────────────────────────┐
│              REST API (Hono)                │
│          /v1/* — auth via Bearer key        │
└──────┬──────────┬──────────────┬────────────┘
       │          │              │
  ┌────▼────┐ ┌───▼────┐  ┌─────▼──────┐
  │Registry │ │Router  │  │  Monitor   │
  │+ Price  │ │Engine  │  │ (Prober +  │
  │Oracle   │ │(pure)  │  │  Passive)  │
  └────┬────┘ └───┬────┘  └─────┬──────┘
       └──────────▼──────────────┘
              ┌────────┐
              │  MPP   │
              │ Proxy  │ ← mppx (402 flow)
              │+ Take  │
              │  Rate  │
              └────────┘

Storage: PostgreSQL (providers, keys, spend, take-rate log) + Redis (price cache 60s, auth cache 60s)

Settlement: Take-rate auto-settles to operator Tempo wallet when balance ≥ $1.00 or every hour.

bun run dev          # Start all services
bun run build        # Build all packages
bun run test         # Run all tests (Vitest)
bun run typecheck    # TypeScript check
bun run lint         # Lint
bun run format       # Prettier
bun run db:migrate   # Apply DB schema

Named after Miss Minutes from Loki — she routes entities through the TVA's Sacred Timeline. TheMinutes routes your agents through the right MPP service. The name also ties to Tempo (Latin: time).

MIT