Tools - Boxpressd Developer Documentation

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 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`

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