Skip to main content
Glama
getvexi

Vexi MCP Server

Official
by getvexi

@getvexi/mcp

npm version License: MIT Website

Structured business data for AI agents - connect Claude, Cursor, and any MCP-compatible client to the Vexi API in 30 seconds.


What is Vexi?

Vexi is a structured business data API designed for AI agents. Instead of scraping and parsing raw HTML, your agent gets a clean, typed Agent Business Object (ABO) - a JSON document with identity, offerings, contact channels, trust signals, and quality metadata.

With one call, agents can discover businesses, fetch full records, and request fresh crawls when data is missing or stale.


Related MCP server: AI List My Business

Prerequisites


Installation

Claude Desktop

  1. Open your Claude Desktop MCP configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  1. Add or merge the vexi server entry under mcpServers.

  2. Paste the following configuration (replace the API key with yours):

{
  "mcpServers": {
    "vexi": {
      "command": "npx",
      "args": ["-y", "@getvexi/mcp"],
      "env": {
        "VEXI_API_KEY": "vxi_live_..."
      }
    }
  }
}

Windows users: If npx doesn't work, use the cmd wrapper instead:

{
  "mcpServers": {
    "vexi": {
      "command": "cmd",
      "args": ["/C", "npx", "-y", "@getvexi/mcp"],
      "env": {
        "VEXI_API_KEY": "vxi_live_..."
      }
    }
  }
}
  1. Save the file and fully quit Claude Desktop.

  2. Relaunch Claude Desktop - the vexi tools should appear in your MCP tools list.

Cursor

  1. Open Cursor.

  2. Go to Settings > MCP.

  3. Add a new server:

  • Command: npx

  • Args: -y, @getvexi/mcp

  • Env: VEXI_API_KEY=vxi_live_...

  1. Save and restart Cursor.

Other MCP clients

Run the server via stdio:

npx -y @getvexi/mcp

Set VEXI_API_KEY in the process environment before starting the client.


Available Tools

Tool

Description

search_businesses

Search for businesses by query and location

get_business

Get a full ABO for a specific business by slug

crawl_business

Queue a new business for crawling

list_categories

List all available business categories


Example Usage

User: Find the top 3 CRM platforms in the US.

Claude calls search_businesses:

{
  "query": "CRM platform",
  "location": "US",
  "limit": "3"
}

Claude: Here are three CRM platforms in the US:

Business

Completeness

HubSpot

0.94

Salesforce

0.97

Pipedrive

0.89


User: Give me full details on HubSpot.

Claude calls get_business:

{
  "slug": "hubspot"
}

Claude: Returns the full ABO for HubSpot - identity, offerings, contact channels, trust signals, operations, agent interface hints, and quality metadata in one structured document.


ABO Schema

Every business is returned as an Agent Business Object with eight top-level sections:

{
  "identity": {
    "id": "biz_hubspot",
    "name": "HubSpot",
    "slug": "hubspot"
  },
  "offerings": {
    "products": ["CRM", "Marketing Hub", "Sales Hub"],
    "price_range": "$$"
  },
  "location": {
    "headquarters": "Cambridge, MA",
    "country": "US"
  },
  "contact": {
    "website": "https://hubspot.com",
    "email": "support@hubspot.com"
  },
  "trust": {
    "rating": 4.5,
    "review_count": 12000
  },
  "operations": {
    "founded_year": 2006,
    "employee_range": "5000+"
  },
  "agent_interface": {
    "summary": "Inbound marketing and CRM platform for SMBs and enterprises",
    "suggested_queries": ["Compare pricing tiers", "List integrations"]
  },
  "quality": {
    "completeness_score": 0.94,
    "last_updated": "2026-05-28T12:00:00Z"
  }
}

Get your API Key

Sign up at https://getvexi.dev/signup.

Start free with 500 credits - no credit card required.



License

MIT

Available Tools

4 tools
crawl_businessC

Queue a new business for crawling from a URL.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesWebsite URL to crawl
waitNoWait for crawl to complete before returning (optional)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It says 'queue,' suggesting asynchronous operation, but does not explain how to check completion, handle errors, or that crawling may take time. No mention of side effects or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no redundant words. It is front-loaded with the key action and resource, though it may be overly brief given the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, but the description does not hint at return values or behavior (e.g., returns a crawl_id). Given the tool has a non-trivial action (queuing and waiting), the description is incomplete for an AI agent to know how to interpret results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already describes both parameters. The description adds no additional nuance beyond 'queue a new business,' which reiterates the tool's purpose. Baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('queue') and resource ('business for crawling from a URL'). It distinguishes from siblings like get_business (retrieve cached) and search_businesses (search), but does not explicitly contrast them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives, such as get_business for cached data. The description implies it is for starting a crawl, but omits prerequisites or context like needing authentication or URL validity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_businessC

Get a full ABO for a specific business by slug.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugYesBusiness slug identifier

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must convey behavioral traits. It only states 'Get', implying a read operation, but does not disclose any side effects, authentication needs, or data scope. The term 'full ABO' is vague about what exactly is returned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence with no wasted words. It is front-loaded and efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema and no description of return value. Low complexity with one parameter, but the description fails to clarify what 'full ABO' entails, leaving the agent uninformed about the response structure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter 'slug' with schema description 'Business slug identifier'. Schema coverage is 100%, so description adds no extra meaning beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses 'Get' as a verb and specifies the resource as 'full ABO' with the method 'by slug'. However, the term 'ABO' is unexplained acronym, causing ambiguity. It distinguishes from siblings like 'search_businesses' by implying a single-object retrieval.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like 'crawl_business' or 'search_businesses'. The description lacks context on prerequisites or scenarios for usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_categoriesA

List all available business categories.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It only says 'List', implying a read operation, but does not disclose pagination, caching, or other behavioral traits. For a zero-parameter list, this is adequate minimal disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no unnecessary words. Every part is relevant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no output schema and no parameters. The description is minimal but sufficiently explains the tool's core function. However, it could mention the return format or potential empty results for completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and schema coverage is 100% (empty). The description does not need to add parameter details. Baseline for zero parameters is 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List all available business categories' clearly states the verb (List) and resource (business categories), and it distinguishes the tool from siblings like crawl_business, get_business, and search_businesses.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies that the tool is used to retrieve all categories, but it does not explicitly state when to use it versus alternatives or provide any exclusions or context-specific guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_businessesC

Search for businesses by query and location. Returns Agent Business Objects (ABOs).

ParametersJSON Schema
NameRequiredDescriptionDefault
qNoSearch query (business name, keyword, or free-text)
locationNoCity, state, country, or geo hint (optional)
business_typeNoBusiness type or category filter (optional)
limitNoMax number of results to return (optional)
min_completenessNoMinimum ABO completeness score 0-1 (optional)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits but only states that it searches and returns ABOs. It omits details like pagination, ordering, rate limits, or error handling, which are critical for AI agents.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with two sentences, no redundant information, and the purpose is front-loaded. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 5 optional parameters and no output schema, the description is insufficient. It does not explain what an ABO is, how results are sorted, or how to use optional parameters effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds no new meaning beyond the schema; it merely restates the presence of query and location parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches for businesses by query and location, and mentions the output type (ABOs). It is distinguishable from sibling tools like 'crawl_business' or 'get_business' which focus on specific businesses.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. There are no exclusions or when-not scenarios mentioned. The purpose is implied but not explicitly contextualized.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A3.7/5.0
Disambiguation5/5

Each tool serves a distinct purpose: crawl queues a business, get retrieves by slug, lists categories, and searches by query/location. No overlap.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (crawl_business, get_business, list_categories, search_businesses).

Tool Count5/5

Four tools are appropriate for a business data server, covering core operations without being too many or too few.

Completeness5/5

The tool set covers creation via crawling, retrieval, search, and category listing. Missing update/delete are likely intentional for a crawling-focused server, so no gaps.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Country-agnostic MCP-callable directory for AI agents to find local SMBs — realtors, insurance agents, medical practitioners — by category, location, or natural-language query. Returns business catalog data and UTM-tagged booking URLs (zero PII).
    5
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables agents to search, retrieve, and contribute business data from a directory of 11M+ businesses across 195 countries, returning markdown prose by default.
    22
    115
    3
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Provides AI agents with access to real, verifiable businesses with provenance and source URLs, enabling natural-language business search and profile retrieval.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/getvexi/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server