Skip to main content
Glama

Server Details

Access Versium's B2B2C identity graph directly through your AI agent. Generate targeted lead lists, enrich records with contact and firmographic data, validate emails, and size audiences — all through natural language. No manual exports or API coding required. Requires an active Versium REACH subscription with API access.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.7/5.0

Scored across 25 tools

Disambiguation4/5

Most tools have clearly distinct targets: list/project CRUD, job lifecycle, listgen estimation vs. options, and ad-export options/status/start are well separated, and the append tools even carry explicit trigger phrases ('B2B2C', 'C2B'). The main soft spot is among the enrichment appends, where contact_append (address/email/phone), demographic_append (household/lifestyle), and b2b2c_append/c2b_append operate on overlapping consumer/business records and require reading descriptions carefully to choose correctly.

Naming Consistency3/5

There is a readable grouping (all *_append tools, all b2b_/b2c_listgen_* tools, verb_noun for REACH resources), but conventions are genuinely mixed across the set. Verb-first names (list_lists, show_list, create_job, preview_list) coexist with noun-first names (contact_append, email_validation, job_status, ads_export_status), and the same ad-export domain uses both ads_export_options and export_list_to_ads.

Tool Count3/5

At 25 tools this sits at the heavy end of the acceptable range, though the server legitimately spans several sub-domains (listgen, enrichment appends, list/job/project management, ad exports, docs). A few pairs feel like they could be consolidated or folded (e.g., b2b/b2c estimate+options quartet, ads_export_options vs. ads_export_status), which pushes it to borderline rather than well-scoped.

Completeness3/5

The core workflow is fully covered: import or generate a list, setup_list, create_job, job_status, preview_list, then export to ads with status polling. However, lifecycle gaps are notable — there is no delete/archive for lists or projects, no job cancellation or job listing, and no way to download/export a finished list's data outside of ad platforms, leaving agents at dead ends for cleanup and result retrieval.

Available Tools

25 tools
ads_export_optionsAds Export Options Mcp ToolA
Read-onlyIdempotent
Inspect
Discover where a list can go in an Ad Platform Export: the ad platforms REACH supports, whether the user has connected each one, and the ad accounts of connected platforms.

Pass `platform` and `account_id` to also get that account's existing Ad Platform Audiences, which `export_list_to_ads` can add to with `audience_id`. Pass `list_id` to see whether that list can be exported to each platform, and why not: only a list with Online Audience output can be, each platform has a minimum record count, and an expired list (`list_expired`, past its `expires_at`) can't be exported at all, so the user needs a new list, for example by running the job again.

An unconnected platform is listed with `connected: false`. Connecting happens only in the REACH web app, on the Integrations page; ask the user to do it there.

Inputs: list_id, platform, account_id. Returns: list_id, platforms

ads_export_statusAds Export Status Mcp ToolA
Read-onlyIdempotent
Inspect
Check an Ad Platform Export started with `export_list_to_ads`, by its `history_id`.

`status` moves from queued through uploading to success or failed. On success, `audience_id` is the Ad Platform Audience in the user's ad account; on failure, `error_message` says what to do next.

Inputs: platform (required), history_id (required). Returns: status, list_id, platform, account_id, +3 more

b2b2c_appendB2 B2 C Append Mcp ToolA
Read-onlyIdempotent
Inspect
Enrich a business contact in a marketing list with their consumer-side profile, so B2B audiences can be reached through consumer channels: with a LinkedIn URL or a name + city/state, append business email plus consumer mobile phone, consumer email, and consumer address data in a single match.
Use this tool when users ask for 'B2B2C', 'b2b2c', or 'Business to Business to Consumer' data.

**Tips for Best Results:**
- Provide a LinkedIn URL (format: linkedin.com/in/username) for the best match quality
- Alternatively provide first name, last name, city, and state together
- Choose one or more outputs; use `required_outputs` to return only records that matched those outputs

Inputs: outputs (required), zip, city, last, +9 more. Returns: results, query_id, warnings, input_query, +3 more

b2b_listgen_estimateB2B Listgen Estimate Mcp ToolA
Read-onlyIdempotent
Inspect
Estimate business contact audience sizes with firmographic and role-based targeting using Versium's B2B Persona Audience Builder (B2B Listgen) API.

**Tips for Best Results:**
- Start with a single output type and add filters incrementally
- Combine geography with company size or industry filters for precise targeting
- Use title_seniority for leadership focus, or department for functional targeting
- Provide SIC codes when you need strict industry alignment
- To check values for fields with large, high-cardinality option sets, call the B2B Persona Listgen Options tool
- Toggle `cfg_b2cloc` to switch between business-location and home-location targeting

Inputs: d_sic, d_zip, output, d_naics, +10 more. Returns: results, query_id, warnings, input_query, +3 more

b2b_listgen_optionsB2B Listgen Options Mcp ToolA
Read-onlyIdempotent
Inspect

Return allowed option values for B2B Persona Listgen filter fields such as NAICS, department and role.

Use this tool when you need the valid values for large, high-cardinality fields too big to embed directly in tool schemas.

Inputs: field, limit, query, offset. Returns: field, query, offset, values, +3 more

b2c_listgen_estimateB2C Listgen Estimate Mcp ToolA
Read-onlyIdempotent
Inspect
Estimate consumer audience sizes using Versium's Consumer Audience Builder (B2C Listgen) API. Supports the configuration and demographic filter set

For fields with large, high-cardinality option sets (e.g. esthhldincome), use the Consumer Audience Options tool to retrieve available values
Any property restricted to `enum: ["Y"]` is enabled by sending `"Y"`. For example, pet owners who golf in Washington use `{"state":["WA"],"d_pets":"Y","d_golf":"Y"}`.
Call `b2c_listgen_options` with `field: "attribute_flags"` when you need the human-readable meanings of those flag names.

**Tips for Best Results:**
- Start with a single output type and add filters incrementally
- Combine geography with age, income, or lifestyle filters for precise targeting
- Leverage lifestyle and interest filters to reach specific consumer segments

Inputs: d_age, d_lor, d_zip, d_golf, +91 more. Returns: results, query_id, warnings, input_query, +3 more

b2c_listgen_optionsB2C Listgen Options Mcp ToolA
Read-onlyIdempotent
Inspect

Return allowed option values for Consumer Audience Builder (B2C Listgen) fields

Use this tool when you need the valid values for large, high-cardinality fields too big to embed directly in tool schemas

Inputs: field, limit, query, offset. Returns: field, query, offset, values, +3 more

c2b_appendC2B Append Mcp ToolA
Read-onlyIdempotent
Inspect
Enrich consumer marketing records with business demographics for B2B segmentation. Match the record with a LinkedIn URL, or with first name, last name, and one of: email, phone, or city and state. Appends job title, seniority, department, business email, LinkedIn profile, and complete business information.
Use this tool when users ask for 'C2B', 'c2b', or 'Consumer to Business Person' data

**Tips for Best Results:**
- Provide full name and consumer email for best match quality
- LinkedIn URLs must be in format: linkedin.com/in/username
- Use `rcfg_require_email` to return only records with business email
- Use `rcfg_require_value` to filter by job title, department, or other attributes

Inputs: city, last, email, first, +7 more. Returns: results, query_id, warnings, input_query, +3 more

contact_appendContact Append Mcp ToolA
Read-onlyIdempotent
Inspect
Enrich marketing contact records with mailing address, email, and phone for outreach and audience building

**Tips for Best Results:**
- Provide as many input fields as possible to improve match quality
- Use `indiv` match type when targeting a specific person
- Request one output type per call when optimizing for match quality (especially for phone outputs)
- Set `cfg_maxrecs` when more than one record is acceptable

Inputs: outputs (required), zip, city, last, +11 more. Returns: results, query_id, warnings, input_query, +3 more

create_jobCreate Job Mcp ToolAInspect
Create a listgen job, or a batch enrichment job over one of the user's lists.

For enrichment, run `setup_list` on the list first. Use `project_id` when possible. For charge-on-finish jobs, tell the user about usage and only submit `usage_consent_confirmed = true` after they consent. The `consent_required_job_types` meta field lists them; for contact_append it depends on `sub_jobs`.

Inputs: name (required), config (required), job_type (required), project_id, +4 more. Returns: job_id, job_guid, job_state, list_name, +5 more

create_projectCreate Project Mcp ToolAInspect

Create a new REACH project for the authenticated user.

Use this tool when a user asks to create a project container before working with lists.

Inputs: project_name (required). Returns: created_at, project_id, project_name

demographic_appendDemographic Append Mcp ToolA
Read-onlyIdempotent
Inspect
Append consumer marketing records with household and lifestyle insights for audience segmentation, across demographic and lifestyle categories

**Tips for Best Results:**
- Request only the insight categories you need to keep responses focused
- Combine name, location, and digital identifiers (email or phone) for higher match confidence
- Use `cfg_required` or `rcfg_require_value` to enforce must-have attributes in the response

Inputs: outputs (required), zip, city, last, +10 more. Returns: results, query_id, warnings, input_query, +3 more

email_validationEmail Validation Mcp ToolA
Read-onlyIdempotent
Inspect
Validate email addresses and optionally get alternate valid emails using Versium's Email Validation API. Returns validation status, sub-status, and whether the email is valid for mailing.

**Tips for Best Results:**
- Provide a valid email address or MD5/SHA256 hashed email (HEM)
- Use `include_alternate` to get an alternate valid email if the input is invalid
- Provide additional contact info (name, address) to improve alternate email matching
- Use `rcfg_exclude_domains` to filter out unwanted email domains from alternates

Inputs: email (required), zip, city, last, +8 more. Returns: results, query_id, warnings, input_query, +3 more

export_list_to_adsExport List To Ads Mcp ToolA
Destructive
Inspect
Start an Ad Platform Export: push a list's Online Audience to the user's connected ad account as an Ad Platform Audience. Not billed.

Find the platform, `account_id` and, to add to an existing Ad Platform Audience, its `audience_id` with `ads_export_options`. Pass `audience_name` to create a new Ad Platform Audience instead. The export runs in the background; check it with `ads_export_status` and the returned `history_id`.

Only one export of a list to a platform runs at a time. When one is already running, no new export starts: `already_in_progress` is true and the response describes the running export, whose account and audience may differ from this request.

Inputs: list_id (required), platform (required), account_id (required), audience_id, +1 more. Returns: status, list_id, message, platform, +5 more

firmographic_appendFirmographic Append Mcp ToolA
Read-onlyIdempotent
Inspect
Enrich business records with firmographics for account targeting and segmentation: company details, location, industry classifications, employee counts, and revenue data.

**Tips for Best Results:**
- Provide domain for fastest, most accurate results
- For business name searches, include complete address information or phone number
- Use `rcfg_require_value` to filter for specific industries or business characteristics

Inputs: zip, city, email, phone, +6 more. Returns: results, query_id, warnings, input_query, +3 more

import_cloud_listImport Cloud List Mcp ToolAInspect
Import a Google Drive or OneDrive file into REACH as a new list, using the Google Sheets or OneDrive account the user connected in REACH.

REACH doesn't browse drives: find the file with a Google Drive or OneDrive/Microsoft 365 MCP server, then pass its `url`, or `provider` and `file_id` (plus `drive_id` for OneDrive files outside the user's own drive). Next, call `setup_list` with the returned `list_id`, then `create_job`.

Supported: Google Sheets, .csv and .xlsx files on Google Drive; .csv and .xlsx files on OneDrive. Rows beyond the user's upload limit are dropped; `record_count` reflects what was kept.

Inputs: url, file_id, drive_id, provider, +3 more. Returns: source, list_id, list_url, list_name, +5 more

ip_to_domain_appendIp To Domain Append Mcp ToolA
Read-onlyIdempotent
Inspect
Discover business domains and firmographic information from IP addresses using Versium's IP-to-Domain API. Accepts an IPv4 address and returns up to 3 associated business domains with details like company name, address, industry, employee count, and revenue.

**Tips for Best Results:**
- Provide a valid IPv4 address for best results
- Useful for identifying businesses from web traffic or server information
- Returns comprehensive firmographic data similar to domain-based lookups

Inputs: ip (required), rcfg_max_time. Returns: results, query_id, warnings, input_query, +3 more

job_statusJob Status Mcp ToolA
Read-onlyIdempotent
Inspect
Check the status of an existing job after `create_job`.

Use this tool to poll progress, ETA, and output list readiness while a job is running or after it finishes.

Inputs: job_id (required). Returns: job_id, job_guid, list_url, job_state, +9 more

list_listsList Lists Mcp ToolA
Read-onlyIdempotent
Inspect

List REACH lists for the authenticated user.

Optionally filter by project or name prefix.

Inputs: limit, search, project_id. Returns: lists

list_projectsList Projects Mcp ToolA
Read-onlyIdempotent
Inspect
List REACH projects for the authenticated user.

Use this tool to find the right project before calling `show_project`.

Inputs: limit, search. Returns: projects

preview_listPreview List Mcp ToolA
Read-onlyIdempotent
Inspect
Preview a sample of rows from a REACH list.

Use this tool to inspect the actual data rows in a list. Returns a row sample
from the list file. The optional `count` parameter is a hint for how many rows
to return; the actual number may differ depending on list type and backend
preview behavior. When omitted, the service default applies.

Inputs: list_id (required), count. Returns: rows, list_id, list_url, returned_rows

setup_listSetup List Mcp ToolA
Destructive
Inspect
Map a REACH list's columns to the input fields a job type reads, so `create_job` can run on it.

1. Call without `header_map`; this call changes nothing. When `already_mapped` is true, `header_map` is the list's saved mapping: go to `create_job`. Otherwise `header_map` is REACH's guess, shown with `sample_rows`.
2. Confirm doubtful columns and any unmapped needed field with the user against `sample_rows`, then call again with `header_map` to apply it. The list needs every field of at least one of `required_field_sets`.
3. When `is_valid_for_job_type` is true, call `create_job`, which still checks the list's size, export status and the account's access.

REACH-generated lists keep the mapping their job gave them; only Data Workbench output, lists with a field mapped to several columns, and b2b2c_append accept a new one.

Inputs: list_id (required), job_type (required), has_header, header_map. Returns: applied, list_id, job_type, has_header, +7 more

show_listShow List Mcp ToolA
Read-onlyIdempotent
Inspect

Show one REACH list and a summary of its latest job.

Use this tool when you already know the list ID and need full metadata plus job status.

Inputs: list_id (required). Returns: list, job_summary

show_projectShow Project Mcp ToolA
Read-onlyIdempotent
Inspect

Show one REACH project and a small summary of its lists.

Use this tool when you already know the project ID and need counts plus a recent-list preview.

Inputs: project_id (required). Returns: project, list_summary

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Remote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.
      16
      11 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Browse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources