PG:AI exposes 5 tools through the MCP server. Your AI assistant automatically selects the right tool based on your request - you don’t need to call them directly. This page documents what each tool does and what parameters it accepts.
pgai_company
Get comprehensive data about a company. Returns structured insights, financials, technology stack, job postings, contacts, content, and more. Use the include parameter to select exactly which data you want.
Parameters
Parameter Type Required Description company_namestring No Company name - automatically matched against your tracked accounts company_idstring No PG:AI company UUID, if you already know it includearray No Which data sections to return. Defaults to ["profile", "insights"] jobs_querystring No Filter job postings by keyword (e.g. “data engineer”). Only used when include contains jobs
You must provide either company_name or company_id. Company names are fuzzy-matched against your tracked accounts, so “Airtable” or “airtable” will both work.
Include Sections
Choose which sections of company data to retrieve:
Section Description profileCompany overview - name, domain, industry, description, employee count insightsStrategic insights generated by PG:AI about the company enrichedEnriched company data from external sources custom_dataAny custom data fields your team has added
Section Description financialsRevenue, growth metrics, and key financial data share_priceCurrent and historical share price data analyst_estimatesAnalyst forecasts and consensus estimates
Section Description contacts_summarySummary of known contacts at the company divisionsCompany divisions and business units competitorsKnown competitors
Section Description technologiesTechnology stack - tools, platforms, and infrastructure jobsCurrent job postings (filterable with jobs_query) eventsPublic events - conferences, webinars, announcements contentCompany-produced content - blog posts, press releases public_docsPublic documents - annual reports, SEC filings, earnings transcripts engage_insightsEngagement-specific insights from your sales activities
Example Prompts
“Get Airtable’s profile and technology stack”
“Show me everything about Harness - financials, insights, and competitors”
“What jobs is Tesco hiring for that mention data engineer?”
“Pull up the latest insights and engagement activity for Frasers Group”
pgai_search
Search across all your PG:AI data. Find companies, contacts, documents, insights, job postings, or technologies - scoped to a specific company or across your entire account.
Parameters
Parameter Type Required Description querystring Yes What to search for scopestring No What to search. Defaults to all company_namestring No Limit search to a specific company company_idstring No Limit search to a specific company by UUID limitnumber No Maximum results to return (default 10)
Search Scopes
Scope What It Searches allCompanies, contacts, documents, and insights (default) companiesCompany names and profiles contactsPeople - names, titles, emails documentsAnnual reports, earnings transcripts, SEC filings insightsAI-generated strategic insights jobsJob postings across tracked companies technologiesTechnology stacks and tools
Example Prompts
“Search for CTO contacts at my tracked accounts”
“Find documents about cloud migration at Frasers Group”
“Search for companies using Snowflake”
“Look for job postings mentioning Kubernetes”
Get full details for a specific contact. Returns name, title, email, LinkedIn, company, and any additional information PG:AI has about the person.
Parameters
Parameter Type Required Description contact_idstring Yes Contact UUID
Don’t know the contact ID? Use pgai_search with scope: "contacts" first to find contacts by name or title, then use pgai_contact to get full details.
Example Prompts
“Search for Sarah at Airtable, then get her full contact details”
“Find VPs of Engineering and show me their full profiles”
pgai_create
Add data to PG:AI. Add companies to your tracked accounts or save contacts you’ve discovered.
Parameters
Parameter Type Required Description typestring Yes What to create: company or contact company_namestring No Company name. Required for company type. For contact type, the company the contact belongs to company_domainstring No Company website domain (e.g. “stripe.com”). Used for company creation company_idstring No Company UUID - for adding a contact to a known company contact_namestring No Contact’s full name contact_emailstring No Contact’s email address contact_titlestring No Contact’s job title contact_linkedinstring No Contact’s LinkedIn profile URL
Creating a Company
Provide at least a company_name or company_domain:
“Add Stripe to my tracked accounts”
“Start tracking datadog.com”
Provide at least a contact_name or contact_email:
“Save John Smith, VP of Engineering at Airtable, [email protected] ”
“Add this contact I found: Jane Doe, CTO at Acme Corp, LinkedIn: linkedin.com/in/janedoe”
pgai_generate
Generate AI content using PG:AI’s workflows. Creates meeting preps, personalised emails, multi-step sequences, call scripts, value pyramids, enablement guides, and contact research - all powered by your account intelligence.
Parameters
Parameter Type Required Description typestring Yes What to generate (see types below) company_namestring Yes *Target company name company_idstring Yes *Target company UUID contact_idstring No Target contact UUID - for personalised emails and meeting prep topicstring No Context for the generation - meeting topic, email purpose, sequence focus tonestring No Tone of voice: professional, casual, formal, consultative num_stepsnumber No Number of steps for sequence generation (default 5)
A company is always required - provide either company_name or company_id. Company names are automatically resolved against your tracked accounts.
Generation Types
Type Description Key Parameters meeting_prepComprehensive meeting preparation pack with company background, talking points, and strategic angles topic sets the meeting topicemailSingle personalised email topic sets the email purpose, tone sets the voice, contact_id for personalisationsequenceMulti-step email sequence topic sets the focus area, num_steps controls length (default 5)call_scriptStructured call script with opening, questions, and objection handling topic sets the meeting context, tone defaults to consultativecall_analysisAnalysis and review of a call topic sets the analysis focusvalue_pyramidValue proposition framework tailored to the company topic sets the focus areaenablement_guideSales enablement guide for the account topic sets the focus areacontact_researchFind and rank contacts at a company topic sets the search query, num_steps controls how many results (default 10)
Example Prompts
“Generate meeting prep for my call with Airtable about data governance”
“Write a professional email to Sarah at Tesco about our analytics platform”
“Create a 4-step email sequence for Harness focused on CI/CD efficiency”
“Build a call script for reaching out to the CTO at Frasers Group”
“Generate a value pyramid for Snowflake”
“Research the top 5 data contacts at Airtable”