> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxpressd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Review the catalog, matching, billing, and personal tools exposed by Presston AI MCP.

Presston AI MCP exposes typed tools. Your client discovers each input schema through MCP, so you do not pass credentials or user IDs as tool arguments.

## Catalog

| Tool | Purpose |
| - | - |
| `search_cigars` | Search published cigars by text and optional brand. |
| `get_cigar` | Get a cigar by public `cigar_` ID. |
| `get_product` | Get a product by public `product_` ID. |
| `get_vitola` | Get a vitola by public `vitola_` ID. |
| `get_brand` | Get a brand by public `brand_` ID. |
| `lookup_barcode` | Find products and cigar contents from a UPC or EAN. |
| `resolve_cigar` | Resolve imperfect cigar text to ranked catalog candidates. |

## Cigar recognition

| Tool | Purpose | Paid AI behavior |
| - | - | - |
| `detect_cigar_regions` | Detect individual cigars in a larger scene. | Local inference |
| `preprocess_cigar_image` | Crop and normalize an image. | Local processing |
| `find_similar_cigars` | Search local visual embeddings. | Local inference |
| `recognize_cigar_text` | Read band and barcode text. | Credit-gated |
| `fingerprint_cigar_image` | Extract band appearance and typography. | Credit-gated |
| `match_cigar_fingerprint` | Match a fingerprint against stored evidence. | Local lookup |
| `analyze_cigar_wrapper` | Distinguish wrapper variants among candidates. | Credit-gated |
| `analyze_band` | Compare band evidence among candidates. | Credit-gated |
| `identify_band` | Run the complete cigar identification workflow. | Credit-gated fallback |
| `detect_cigar_from_image` | Run Presston-compatible image identification. | Credit-gated fallback |
| `enrich_cigar` | Research and fill structured cigar facts. | Credit-gated external services |

See [Cigar-band matching](/presston-mcp/cigar-band-matching) for a complete example.

## Billing

These tools do not consume a billable usage unit:

| Tool | Purpose |
| - | - |
| `get_billing_status` | Get plan usage, remaining AI credits, and billing actions. |
| `get_billing_usage` | Get normalized current-period usage. |
| `list_billing_plans` | List active developer plans. |
| `list_ai_credit_packs` | List current AI credit offers. |

## First-party personal tools

Personal tools require a delegated Boxpressd user session validated by the MCP server.

| Area | Tools |
| - | - |
| Humidors | `get_user_humidors`, `search_user_humidor`, `get_humidor_contents`, `add_cigar_to_humidor` |
| Smoke sessions | `get_active_smoke_session`, `start_smoke_session_draft`, `add_smoke_session_timeline_note`, `update_smoke_session_draft`, `finish_smoke_session`, `cancel_smoke_session_draft` |
| History | `get_recent_smoking_history`, `get_cigar_smoking_history`, `get_smoking_history_overview`, `get_personal_smoking_insights` |
| Recommendations | `recommend_personalized_cigars`, `get_pairing_intelligence` |
| Places and details | `find_local_venues`, `get_cigar_details` |

<Note>
  A normal third-party developer key does not grant personal user access. Public OAuth consent for third-party agents is a separate future integration.
</Note>