OXYGEN

Lists the organization's standing credit caps by scope and window, plus the plan defaults that apply without one: the daily guard and per-run Agent and trigger ceilings.

oxygen_budget_list

Lists Unibox conversations newest-first across email, LinkedIn, and WhatsApp (the default merged stream); channel narrows to one. Primary excludes the negative status tier; All = ordinary conversations. Status, unread, unanswered, dates are cross-channel; search is fuzzy, spans every non-warmup thread + body, ignores segment/unanswered. Campaign/provider/domain/mailbox facets and Others/Sent/Warmup/DMARC are email-only.

oxygen_inbox_list

Lists this workspace's tables, optionally filtered by project or workspace tag. Newest 200 by default; see `capped`.

oxygen_tables_list

Lists recent workspace runs (provider calls, AI column runs, workflow steps) for the organization, newest first.

oxygen_runs_list

The canonical company-search entrypoint. Compiles prompt + typed filters into provider routes, table columns, gates, credit/match estimates, filter coverage, and workspace context. Discover accepted enums with oxygen_companies_search_preview action=filters first. A route marked invalid_input needs corrected filters and a new estimate. Approval must use the returned max_pages and credit estimate; larger row counts need a new quote. A deterministic_guess match count is an unprobed heuristic; use the free preview for a provider-backed total. COST: free (no paid provider calls; with estimate=true it runs at most ONE free zero-credit count probe). FILTERS: pass typed `filters` (ISO alpha-2 countries, funding stages, employee/revenue/founded ranges, technologies, hiring). extracted_filters.unparsed_constraint_hints reports unparsed constraints; per-route filter_application reports applied/dropped filters. FOLLOW-UP: _plan -> _run (dry_run) -> _run (live, approved=true, max_credits) -> oxygen_table_ingestions_wait -> oxygen_tables_preview.

oxygen_companies_search_plan

Canonical people/contact search: compiles prompt + persona filters into provider routes, table columns, gates, credit/match estimates, filter coverage, and workspace context. COST: free (no paid provider calls; runs at most ONE free zero-credit people-count probe — on by default, pass estimate=false to skip it). FILTERS: pass typed `filters` (titles, seniorities, departments, ISO alpha-2 countries, contactability has-email/has-phone, nested company scope). extracted_filters.unparsed_constraint_hints reports unparsed constraints; per-route filter_application reports applied/dropped filters (only ContactOut honors contactability). SOURCE: source={table, linkedin_url_column} fans Blitz Employee Finder over every company LinkedIn URL in that column — 10 credits per company per page, people linked back to their company row. FOLLOW-UP: _plan -> _run (dry_run) -> _run (live, approved=true, max_credits) -> oxygen_table_ingestions_wait -> oxygen_tables_preview. Upsert-dedupes on linkedin_url.

oxygen_people_search_plan

Call action=filters before previewing; use its accepted enums and nested objects. Preview free. company_search: 50 companies; hiring: 50 job postings with exact total; google_maps: 20 businesses, {q:business type and area}, total unavailable unless returned by API. Report the native source, requested filters, diagnostics, preview_limit and how sample rows were chosen. Next oxygen_companies_search_run with source + source_filters: dry_run, then approved live + max_credits.

oxygen_companies_search_preview

List native Find people filters (people.* and company.*, incl. up to 50 company.linkedin_url) or preview up to 50 people free. Then use oxygen_people_search_run with source=people_search and source_filters: dry_run, then approved live with max_credits.

oxygen_people_search_preview

linkedin_posts only: list the post-search filters, or preview public LinkedIn posts FREE (up to 25 per keyword) with author, engagement and the optional ai_filter applied. Nothing is created or charged. Then oxygen_signals_search_run with family=linkedin_posts and the same filters: dry_run, then live with approved=true, plus max_credits if the dry run quotes ai_filter reasons.

oxygen_signals_search_preview

Rows, columns, stats, and a deep-link, 0 credits. Share the returned web_url. UI in MCP Apps hosts; data in terminals. Fill exact to cap, else summary.statsSampled; rowCount exact.

oxygen_tables_preview

Raw rows. Prefer filterTree; use oxygen_tables_preview to inspect.

oxygen_tables_query

Resolves workspace context and assets. purpose='onboarding' includes a bounded research brief and inferred GTM hypotheses; user corrections take precedence.

oxygen_context_resolve

Dry-runs or queues company sourcing into a Table. Use source=company_search|hiring|google_maps + source_filters from the free preview, or a prompt/plan from oxygen_companies_search_plan. COST: dry_run is free; live requires approval and max_credits. target_count sets pages; max_credits caps them (auto_paged). Provider preflight must pass. FILTERS: prompt filters use the plan schema; native source_filters use preview metadata. TABLE: omit it, or match `output_columns`. NEXT: dry_run -> approved live -> oxygen_table_ingestions_wait -> oxygen_tables_preview.

oxygen_companies_search_run

Dry-runs or queues a live table ingestion run for one people-search provider route. This is the people-search executor; pair it with oxygen_people_search_plan. COST: dry_run is free. Live requires approved=true and max_credits. max_pages is computed from target_count and capped by max_credits (see auto_paged). Required provider preflight blocks live until verified server-side. Rows upsert-dedupe on linkedin_url. FILTERS: when planning from a prompt, pass typed `filters` (and estimate) — identical schema to oxygen_people_search_plan. source="people_search" + source_filters from oxygen_people_search_preview needs no prompt. SOURCE: source={table, linkedin_url_column} fans Blitz Employee Finder over every company LinkedIn URL in that column — 10 credits per company per page, people linked back to their company row. TABLE: omit it, or match `output_columns`. FOLLOW-UP: this tool mode=dry_run -> mode=live, approved=true -> oxygen_table_ingestions_wait -> oxygen_tables_preview.

oxygen_people_search_run

Returns a dry-run request or queues a live table ingestion run for one signal-search route, creating the table from the plan blueprint when none is passed. COST: dry_run is free; live consumes credits within max_credits and requires approved=true. linkedin_posts is free (approved=true only) unless the dry run quotes credits for ai_filter reasons or an ai_filter block. LIVE TABLE: pass bind_feed=true with every to also bind a pull feed to the same table in the same call, so it keeps refilling on a cadence. That is a STANDING spend grant and is refused (feed_not_incremental) when the chosen provider cannot resume where it left off. FOLLOW-UP: oxygen_signals_search_run (mode=live) -> oxygen_table_ingestions_wait -> oxygen_tables_preview.

oxygen_signals_search_run

Runs a column on selected rows. Preview, then pass approved=true + max_credits. limit fills empties. Large runs: execution_status=planning.

oxygen_columns_run

Search wiki pages by meaning and keywords. Read-only, 0 credits. Plain language uses hybrid retrieval when enabled; check match_type/semantic_status. Without the platform-funded embedding allowance, keyword search still works. Quotes, OR and exclusions stay lexical. Non-archived unless status is set. Open results with oxygen_knowledge_page_get and cite revisions; search before creating duplicates.

oxygen_knowledge_search

Switches the active OXYGEN workspace. An org-bound API key cannot: it is refused with org_scoped_credential.

oxygen_orgs_select

Create/update by slug or id; omit both to create by title. Search first to avoid duplicates. Cite [[slug]]. Writes revisions and links. Sensitive canonical edits return knowledge_approval_required with a proposal to approve in OXYGEN.

oxygen_knowledge_page_upsert

Inserts or updates a batch, deduplicating on the key column. dry_run=true first on messy lists.

oxygen_rows_upsert

Polls a durable search/scrape run until terminal status or timeout.

oxygen_search_runs_wait

Polls a table action run until it reaches a terminal status (completed, completed_with_errors, failed, canceled) or the timeout expires. Use after starting a run to watch it finish.

oxygen_table_runs_wait

Polls a durable table ingestion until it reaches a terminal status or the timeout expires.

oxygen_table_ingestions_wait

Returns the Oxygen organization and user this connector session is authorized for, plus factual `onboarding` markers. A null block means unknown, not a workspace that has done nothing. It never prescribes a GTM motion.

oxygen_whoami