---
title: Quickstart
description: Make your first API call in under two minutes.
canonical: https://bennybooks.com/developers/quickstart
markdown: https://bennybooks.com/developers/quickstart.md
---
# Quickstart

Make your first API call in under two minutes.

> **Documentation index.** Fetch [https://bennybooks.com/developers/llms.txt](https://bennybooks.com/developers/llms.txt) before browsing further. Prefer markdown (this file or `Accept: text/markdown`). Site-wide map: [https://bennybooks.com/llms.txt](https://bennybooks.com/llms.txt).

## 1. Create a token

In BennyBooks, go to Settings → MCP & agents and create a token. Choose read for queries or propose-write for agent actions. Copy the bb_live_… value — it is shown only once. Paste MCP config or run npx @bennybooks/cli agent setup.

## 2. List transactions

```bash curl
curl -s "https://bennybooks.com/api/v1/transactions?status=uncategorized&limit=5" \
  -H "Authorization: Bearer bb_live_YOUR_TOKEN" | jq
```

## 3. Propose a categorization

> Requires a propose-write token. The change stays pending until a human approves in Ledger → Approvals. The propose action is also recorded in Log (https://bennybooks.com/log).

```bash curl
curl -s -X POST "https://bennybooks.com/api/v1/proposals/categorization" \
  -H "Authorization: Bearer bb_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "YOUR_TX_ID",
    "categoryCode": "5100",
    "confidence": 0.92,
    "reason": "Recurring SaaS charge",
    "evidence": [{ "type": "keyword", "value": "Software" }]
  }' | jq
```

## 4. Connect an agent

Prefer markdown docs: GET https://bennybooks.com/developers/llms.txt or Accept: text/markdown. See Connect as an AI agent for discovery, WebMCP, and auth.md. Prefer Connect Streamable HTTP MCP; AnythingMCP remains an OpenAPI bridge option.

---

## Machine-readable

- HTML: https://bennybooks.com/developers/quickstart
- Markdown: https://bennybooks.com/developers/quickstart.md
- Docs index: https://bennybooks.com/developers/llms.txt
- OpenAPI: https://bennybooks.com/openapi.json
- Skill: https://bennybooks.com/skill.md
- Auth: https://bennybooks.com/auth.md

```json
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Quickstart",
  "description": "Make your first API call in under two minutes.",
  "url": "https://bennybooks.com/developers/quickstart",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com",
    "logo": {
      "@type": "ImageObject",
      "url": "https://bennybooks.com/apple-icon.png"
    }
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/quickstart",
  "image": "https://bennybooks.com/opengraph-image",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/quickstart.md",
    "encodingFormat": "text/markdown",
    "name": "Quickstart (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```
