Vexi MCP Server
OfficialThe Vexi MCP Server connects AI agents to structured business data via the Vexi API, enabling discovery, retrieval, and crawling of business information in a clean, typed format.
search_businesses: Find businesses using free-text queries (name, keyword, etc.), filtered by location, business type/category, and minimum data completeness score — returns structured Agent Business Objects (ABOs).get_business: Retrieve a complete ABO for a specific business by its unique slug, including identity, offerings, location, contact info, trust signals, operations, and quality metadata.crawl_business: Submit a website URL to queue a new business for crawling, with an option to wait for the crawl to complete before returning results.list_categories: Retrieve all available business categories to assist with filtering and discovery.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vexi MCP Serverfind top CRM platforms in the US"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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
Node.js 18+
A Vexi API key - get one free at https://getvexi.dev/signup
Installation
Claude Desktop
Open your Claude Desktop MCP configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add or merge the
vexiserver entry undermcpServers.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
npxdoesn't work, use thecmdwrapper instead:{ "mcpServers": { "vexi": { "command": "cmd", "args": ["/C", "npx", "-y", "@getvexi/mcp"], "env": { "VEXI_API_KEY": "vxi_live_..." } } } }
Save the file and fully quit Claude Desktop.
Relaunch Claude Desktop - the vexi tools should appear in your MCP tools list.
Cursor
Open Cursor.
Go to Settings > MCP.
Add a new server:
Command:
npxArgs:
-y,@getvexi/mcpEnv:
VEXI_API_KEY=vxi_live_...
Save and restart Cursor.
Other MCP clients
Run the server via stdio:
npx -y @getvexi/mcpSet VEXI_API_KEY in the process environment before starting the client.
Available Tools
Tool | Description |
| Search for businesses by query and location |
| Get a full ABO for a specific business by slug |
| Queue a new business for crawling |
| 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.
Links
Website: https://getvexi.dev
API Docs: https://getvexi.dev/docs
Dashboard: https://getvexi.dev/dashboard
License
MIT
Available Tools
4 toolscrawl_businessC
Queue a new business for crawling from a URL.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Website URL to crawl | |
| wait | No | Wait for crawl to complete before returning (optional) |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Business slug identifier |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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).
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query (business name, keyword, or free-text) | |
| location | No | City, state, country, or geo hint (optional) | |
| business_type | No | Business type or category filter (optional) | |
| limit | No | Max number of results to return (optional) | |
| min_completeness | No | Minimum ABO completeness score 0-1 (optional) |
TDQS
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.
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.
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.
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.
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.
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
Each tool serves a distinct purpose: crawl queues a business, get retrieves by slug, lists categories, and searches by query/location. No overlap.
All tool names follow a consistent verb_noun pattern in snake_case (crawl_business, get_business, list_categories, search_businesses).
Four tools are appropriate for a business data server, covering core operations without being too many or too few.
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
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
Live Google Maps business search, review, and photo data for AI agents over MCP.
Search and verify 360K+ business entities with trust scores and W3C credentials.
Verified Indian business data and AI-visibility reports for MCP-compatible AI agents.
Search real businesses, then read profiles, services and hours or contact them, in one endpoint.
Related MCP Servers
- AlicenseAqualityFmaintenanceUniversal search engine for AI agents. Discover products, services, and businesses across every category. 10 MCP tools, zero LLM calls, millisecond responses.114AGPL 3.0
- AlicenseAqualityBmaintenanceCountry-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).5MIT
- AlicenseAqualityDmaintenanceEnables agents to search, retrieve, and contribute business data from a directory of 11M+ businesses across 195 countries, returning markdown prose by default.221153MIT
- AlicenseAqualityCmaintenanceProvides AI agents with access to real, verifiable businesses with provenance and source URLs, enabling natural-language business search and profile retrieval.2MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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