# BLUEPRINT: Stack Billing [MCP]
# Version: 3.1.3
# URL: https://stackbill.app
# Updated: 2026-05-28

## CAPABILITIES
get-business-profile: https://stackbill.app/blueprints/get-business-profile.txt | mcp
list-clients: https://stackbill.app/blueprints/list-clients.txt | mcp
get-client: https://stackbill.app/blueprints/get-client.txt | mcp
create-client: https://stackbill.app/blueprints/create-client.txt | mcp
list-invoices: https://stackbill.app/blueprints/list-invoices.txt | mcp
get-invoice: https://stackbill.app/blueprints/get-invoice.txt | mcp
create-invoice: https://stackbill.app/blueprints/create-invoice.txt | mcp
list-sessions: https://stackbill.app/blueprints/list-sessions.txt | mcp
log-session: https://stackbill.app/blueprints/log-session.txt | mcp
manage-api-keys: https://stackbill.app/blueprints/manage-api-keys.txt | human-only

## IDENTITY
name: Stack Billing
description: Mobile-first invoicing app for contractors and field workers — log hours, create invoices, and share payment links from the job site without opening a laptop.
category: finance
contact: support@stackbill.app

## SUMMARY
tagline: Log hours on the job site, send an invoice before you leave. No laptop required.
audience: Independent contractors, tradespeople, and field workers who invoice clients for time and materials.
capabilities:
  - create-invoice: Create a draft invoice from hours and rate — returns share link immediately if Auto-Send is enabled in Settings, otherwise saves as draft for user review
  - log-session: Record a completed work session with start/end time and notes
  - list-clients: List all clients with default billing rates
  - list-invoices: List invoices filtered by status (draft, sent, paid)
  - get-invoice: Get full invoice details and shareable payment link
  - list-sessions: View recent work sessions with billable hours and estimated amounts

## AUTH
### Human (web app)
provider: firebase
methods: email-password, oauth-google

### Agent (MCP)
provider: api-key
format: sb_live_*
obtain-at: https://stackbill.app/settings-page?tab=api
note: Firebase tokens do not work on MCP. API keys do not work on REST routes.

## MCP
server: stackbill-mcp
preferred-transport: streamable_http
install: Configure your MCP client with URL https://mcp.stackbill.app and header Authorization: Bearer <your-api-key>
auth: STACK_BILLING_API_KEY — your Stack Billing API key from Settings > API Keys (https://stackbill.app/settings-page?tab=api). Keys start with sb_live_.

### TRANSPORT (streamable_http)
url: https://mcp.stackbill.app
alt-url: https://backend-api-968318684377.us-central1.run.app/mcp
auth: bearer ${STACK_BILLING_API_KEY}

### REQUIRED-SECRETS
- STACK_BILLING_API_KEY:
    description: Your Stack Billing API key for MCP access
    obtain-at: https://stackbill.app/settings-page?tab=api
    format: sb_live_*

## ACCESS
preferred: mcp
last-resort: ui