Skip to main content
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

ParameterTypeRequiredDescription
company_namestringNoCompany name - automatically matched against your tracked accounts
company_idstringNoPG:AI company UUID, if you already know it
includearrayNoWhich data sections to return. Defaults to ["profile", "insights"]
jobs_querystringNoFilter 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:
SectionDescription
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
SectionDescription
financialsRevenue, growth metrics, and key financial data
share_priceCurrent and historical share price data
analyst_estimatesAnalyst forecasts and consensus estimates
SectionDescription
contacts_summarySummary of known contacts at the company
divisionsCompany divisions and business units
competitorsKnown competitors
SectionDescription
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”

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

ParameterTypeRequiredDescription
querystringYesWhat to search for
scopestringNoWhat to search. Defaults to all
company_namestringNoLimit search to a specific company
company_idstringNoLimit search to a specific company by UUID
limitnumberNoMaximum results to return (default 10)

Search Scopes

ScopeWhat 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”

pgai_contact

Get full details for a specific contact. Returns name, title, email, LinkedIn, company, and any additional information PG:AI has about the person.

Parameters

ParameterTypeRequiredDescription
contact_idstringYesContact 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

ParameterTypeRequiredDescription
typestringYesWhat to create: company or contact
company_namestringNoCompany name. Required for company type. For contact type, the company the contact belongs to
company_domainstringNoCompany website domain (e.g. “stripe.com”). Used for company creation
company_idstringNoCompany UUID - for adding a contact to a known company
contact_namestringNoContact’s full name
contact_emailstringNoContact’s email address
contact_titlestringNoContact’s job title
contact_linkedinstringNoContact’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”

Saving a Contact

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

ParameterTypeRequiredDescription
typestringYesWhat to generate (see types below)
company_namestringYes*Target company name
company_idstringYes*Target company UUID
contact_idstringNoTarget contact UUID - for personalised emails and meeting prep
topicstringNoContext for the generation - meeting topic, email purpose, sequence focus
tonestringNoTone of voice: professional, casual, formal, consultative
num_stepsnumberNoNumber 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

TypeDescriptionKey Parameters
meeting_prepComprehensive meeting preparation pack with company background, talking points, and strategic anglestopic sets the meeting topic
emailSingle personalised emailtopic sets the email purpose, tone sets the voice, contact_id for personalisation
sequenceMulti-step email sequencetopic sets the focus area, num_steps controls length (default 5)
call_scriptStructured call script with opening, questions, and objection handlingtopic sets the meeting context, tone defaults to consultative
call_analysisAnalysis and review of a calltopic sets the analysis focus
value_pyramidValue proposition framework tailored to the companytopic sets the focus area
enablement_guideSales enablement guide for the accounttopic sets the focus area
contact_researchFind and rank contacts at a companytopic 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”