Grasp MCP documentation

Building tables

Create and modify Grasp research tables of companies, buyers, or transactions.

grasp_setup_conversation

Initialize a table-building conversation scope. Returns a conversation_id that must be passed to grasp_create_table, grasp_import_table, and grasp_compose_table, so related tables land in one Grasp conversation and stay composable.

grasp_create_table

Create an async company, buyer, or transaction table from one search source. Company and buyer tables include latest revenue/assets evidence columns by default. Returns an async job_id.

grasp_import_table

Create a company table from rows parsed from a CSV or Excel sheet. Matches companies by URL/domain and preserves uploaded columns.

grasp_compose_table

Create a table by composing rows from existing Grasp tables. Components can pin versions, filter rows, and map columns.

grasp_update_table

Update an existing table version: workflow changes, view filters/sort/layout, name, or description.

grasp_add_research_column

Add one AI research column to an existing table. Research runs per eligible row.

Inspecting and querying tables

Read table structure and data without ever pulling the full table into the context window.

grasp_list_tables

List the most recently created tables for the current user, with source types, row/column counts, versions, and app links.

grasp_get_table

Get table metadata, exact columns and column types, version details, row count, and a small preview.

grasp_get_table_rows

Fetch paginated rows with structured filters, one sort, and optional visible columns.

grasp_query_table

Run read-only SQL (Apache DataFusion / ANSI-style SELECT) against Grasp tables. Reference tables by slug in double quotes.

grasp_describe_table

Return aggregate value summaries for selected columns across the full table.

Company and contact lookup

grasp_search_companies

Resolve a free-text name/domain query and/or an exact org number (with an optional country filter) into ranked candidate legal entities with company_id. This is a lexical identity search — for building lists or universes, use grasp_create_table instead.

grasp_get_company

Fetch a company profile by company_id — obtained from grasp_search_companies or a table’s company-id column. Returns identity, business, latest financials, employees, compact ownership, and an acquisition-history summary, with optional sections for similar companies and contacts. Full per-deal detail for known buyers is available separately via grasp_get_buyer_deals.

grasp_get_buyer_deals

Fetch the complete deal history for one known buyer by company_id: paginated deal records (newest first) with target identity and financials, deal year / status / stake, deal size, enterprise value, implied equity value, and EV/Sales, EV/EBITDA, deal-size/Sales, and deal-size/EBITDA multiples with derivation types, plus a coverage summary.

grasp_search_contacts

Search people/contact records for known company domains. Returns names, titles, seniority, email/phone where available, and LinkedIn.

grasp_unlock_contact_emails

Reveal work email addresses for specific contacts returned by grasp_search_contacts, identified by person_id.

Contact data returned by grasp_search_contacts (and grasp_unlock_contact_emails) is sourced from Apollo.io (ZenLeads, Inc.) and processed on a legitimate-interests basis. Individuals can opt out or request removal — see our Privacy Policy.

Exporting

grasp_export_table

Export a table or version to Excel. Returns a signed download URL plus an MCP resource_link (grasp://exports/{export_id}) for clients that support resources/read.

Async jobs

Table-building and research tools run asynchronously and return a job_id.

grasp_check_job_status

Poll any async job. When it succeeds, returns table handles, row/column metadata, and a small preview.

grasp_cancel_job

Cancel a pending job before it starts.

Documentation

grasp_read_docs

Read in-server documentation covering schemas, entity types, source filters, data columns, financials, research columns, SQL, exports, progress, contacts, examples, workflows, and common validation errors.