create_g2_intent_static_audience
Create a **G2 Intent (Static)** audience (platform `customAudienceType=G2_ABM_CONTACT`).
Writes audiences
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Create a **G2 Intent (Static)** audience (platform `customAudienceType=G2_ABM_CONTACT`).
AUDIENCE TYPE (mirrors the UI's "Audience Type" dropdown):
• UI label: "G2 Intent (Static)"
• Platform enum: G2_ABM_CONTACT
• SNAPSHOT at creation time — does NOT refresh daily.
PREREQUISITE:
• G2 integration MUST be connected.
WHEN TO USE (exact user phrasing this tool should match):
• "G2 Intent (Static)"
• "Static G2 audience"
• The user explicitly wants the static / snapshot variant rather than the daily-refreshing dynamic one.
WHEN NOT TO USE:
• If the user said "Dynamic" → use `create_g2_intent_dynamic_audience` or `create_g2_intent_linkedin_native_dynamic_audience`.
BUYING STAGES — REQUIRED BY THE PLATFORM:
ASK the user if missing. DO NOT default.
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
- location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
- location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
- job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
- job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS:
Valid job function IDs and their labels:
- 1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
- 7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
- 13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
- 18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
- 22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
- 25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
- job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
- job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS:
Valid seniority IDs and their labels:
- 2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
- 8: Senior, 9: Owner, 10: Entry, 11: Partner
- seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
- seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
- contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
- All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
- Job titles are free text strings, not IDs
- Use include parameters to specify which criteria to target
- Use exclude parameters to filter out contacts matching specific criteria
- Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
- Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
- location_country_ids: Array of country IDs (optional)
- location_state_ids: Array of state IDs (optional)
- job_title_includes: Array of job title keywords to include (optional)
- job_title_excludes: Array of job title keywords to exclude (optional)
- job_function_include_ids: Array of job function IDs (optional)
- job_function_exclude_ids: Array of job function IDs (optional)
- seniority_include_ids: Array of seniority level IDs (optional)
- seniority_exclude_ids: Array of seniority level IDs (optional)
- contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS:
• name (required, ≤ 50 chars)
• intent_days (required, 1-365)
• buying_stages (REQUIRED — ask if missing)
• Contact criteria as in CONTACTS CRITERIA above.
RETURNS: id, audience_id, audience_name, audience_type (G2_ABM_CONTACT), status, buying_stages, intent_days, counts.Arguments
| Argument | Type | Notes | |
|---|---|---|---|
name |
string | required | Audience name (required, max 50 characters). |
intent_days |
integer | required | Days to look back for G2 intent signals (required, 1-365). |
buying_stages |
array | Buying stages to target. The platform REQUIRES at least one; if the user did not specify, ASK them before calling — do NOT default. | |
location_country_ids |
array | Country IDs for geographic targeting (optional). Valid IDs: 1 (Afghanistan), 2 (Albania), 3 (Algeria), 4 (American Samoa), 5 (Andorra), 6 (Angola), 7 (Anguilla), 8 (Antarctica), 9 (Antigua and Barbuda), 10 (Argentina), 11 (Armenia), 12 (Aruba), 13 (Australia), 14 (Austria), 15 (Azerbaijan), 16 (Baha | |
location_state_ids |
array | State IDs for geographic targeting (optional). Valid US State IDs: 1 (Alabama), 2 (Alaska), 3 (Arizona), 4 (Arkansas), 5 (California), 6 (Colorado), 7 (Connecticut), 8 (Delaware), 9 (Florida), 10 (Georgia), 11 (Hawaii), 12 (Idaho), 13 (Illinois), 14 (Indiana), 15 (Iowa), 16 (Kansas), 17 (Kentucky), | |
job_title_includes |
array | Free text keywords for job titles to include (optional). Example: ['Software Engineer', 'Manager'] | |
job_title_excludes |
array | Free text keywords for job titles to exclude (optional). Example: ['Senior', 'Lead'] | |
job_function_include_ids |
array | Job function IDs to include (optional). Valid IDs: 1 (Marketing), 2 (Sales), 3 (Customer Service), 4 (Finance), 5 (HR), 6 (PR), 7 (Media), 8 (Design), 9 (Engineering), 10 (Operations), 11 (Legal), 12 (Education), 13 (Health), 14 (Real Estate), 15 (Accounting), 16 (Administrative), 17 (Business Devel | |
job_function_exclude_ids |
array | Job function IDs to exclude (optional). Valid IDs: 1-28 as listed above | |
seniority_include_ids |
array | Seniority level IDs to include (optional). Valid IDs: 2 (Manager), 3 (Director), 4 (VP), 5 (CXO), 6 (Unpaid), 7 (Training), 8 (Senior), 9 (Owner), 10 (Entry), 11 (Partner). Example: [10, 7] for Entry and Training | |
seniority_exclude_ids |
array | Seniority level IDs to exclude (optional). Valid IDs: 2-11 as listed above | |
contacts_per_company_limit |
integer | Maximum number of contacts to target per company (optional). Example: 20 |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_g2_intent_static_audience","arguments":{"name":"<name>","intent_days":0}}}'
Response
No recorded response. This tool writes to the account, so it is never executed to build these docs.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other audiences tools: