Discovery Engine

List available Discovery Engine plans with pricing. No authentication required. Returns all available subscription tiers with credit allowances and pricing. Use this to help users choose a plan.

Estimate cost, time, and credit requirements before running an analysis. Returns credit cost, estimated duration (low/median/high), whether you have sufficient credits, and whether a free public alternative exists. Always call this before discovery_analyze for private runs. Args: file_size_mb: Size of the dataset in megabytes. num_columns: Number of columns in the dataset. num_rows: Number of rows (optional, improves time estimate). depth_iterations: Search depth (1=fast, higher=deeper). Default 1. visibility: "public" (free, results published) or "private" (costs credits). api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Run Discovery Engine on tabular data to find novel, statistically validated patterns. This is NOT another data analyst — it's a discovery pipeline that systematically searches for feature interactions, subgroup effects, and conditional relationships nobody thought to look for, then validates each on hold-out data with FDR-corrected p-values and checks novelty against academic literature. This is a long-running operation (3-15 minutes). Returns a run_id immediately. Use discovery_status to poll and discovery_get_results to fetch completed results. Use this when you need to go beyond answering questions about data and start finding things nobody thought to ask. Do NOT use this for summary statistics, visualization, or SQL queries. Public runs are free but results are published. Private runs cost credits. Call discovery_estimate first to check cost. Args: file_path: Path to the dataset file (CSV, TSV, Excel, JSON, Parquet, ARFF, Feather). target_column: The column to analyze — what drives it, beyond what's obvious. depth_iterations: Search depth (1=fast, higher=deeper). Default 1. visibility: "public" (free) or "private" (costs credits). Default "public". title: Optional title for the analysis. description: Optional description of the dataset. api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Check the status of a Discovery Engine run. Returns the current status (pending, processing, completed, failed) and progress information. Poll this after calling discovery_analyze — runs typically take 3-15 minutes. This is a lightweight status check. Use discovery_get_results to fetch the full results once the run is completed. Args: run_id: The run ID returned by discovery_analyze. api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Fetch the full results of a completed Discovery Engine run. Returns discovered patterns (with conditions, p-values, novelty scores, citations), feature importance scores, a summary with key insights, column statistics, a shareable report URL, and suggestions for what to explore next. Only call this after discovery_status returns "completed". Args: run_id: The run ID returned by discovery_analyze. api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Check your Discovery Engine account status. Returns current plan, available credits (subscription + purchased), and payment method status. Use this to verify you have sufficient credits before running a private analysis. Args: api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Create a Discovery Engine account and get an API key. Zero-touch signup: provide an email address, get back a ready-to-use disco_ API key. The free tier (10 credits/month, unlimited public runs) is active immediately. No authentication required. Returns 409 if the email is already registered. Args: email: Email address for the new account. name: Display name (optional — defaults to email local part).

Attach a Stripe payment method to your Discovery Engine account. The payment method must be tokenized via Stripe's API first — card details never touch Discovery Engine's servers. Required before purchasing credits or subscribing to a paid plan. To tokenize a card, call Stripe's API directly: POST https://api.stripe.com/v1/payment_methods with the stripe_publishable_key from your account info. Args: payment_method_id: Stripe payment method ID (pm_...) from Stripe's API. api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Purchase Discovery Engine credit packs using a stored payment method. Credits cost $1.00 each, sold in packs of 20 ($20/pack). Credits are used for private analyses (public analyses are free). Requires a payment method on file — use discovery_add_payment_method first. Args: packs: Number of 20-credit packs to purchase. Default 1. api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.

Subscribe to or change your Discovery Engine plan. Available plans: - "free_tier": Explorer — free, 10 credits/month - "tier_1": Researcher — $49/month, 50 credits/month - "tier_2": Team — $199/month, 200 credits/month Paid plans require a payment method on file. Credits roll over on paid plans. Args: plan: Plan tier ID ("free_tier", "tier_1", or "tier_2"). api_key: Discovery Engine API key (disco_...). Optional if DISCOVERY_API_KEY env var is set.