MCP Server

visibilityai

io.github.thinksuitesolution-coder/visibilityai
Marketing & Advertising Search & Research Public & reachable MCP 2026-07-28

What this MCP does

Searches and compares verified businesses, provides business profiles and offers, and reports AI visibility and citation data.

compare_businesses
Side-by-side comparison of two businesses. Use when a user wants to choose between two specific providers - returns scores, services, USPs, and key differences.
Input schema
{'type': 'object', 'required': ['slug_a', 'slug_b'], 'properties': {'slug_a': {'type': 'string', 'description': 'Slug of the first business'}, 'slug_b': {'type': 'string', 'description': 'Slug of the second business'}}}
get_available_cities
Discover which cities have listed businesses in a given category. Use before calling search_businesses when the user has not specified a city, or to show coverage.
Input schema
{'type': 'object', 'required': ['category'], 'properties': {'category': {'type': 'string', 'description': 'Business category to check coverage for'}}}
get_business_profile
Get the full AI-optimized profile of a specific business. Use when you already know the business slug.
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Business slug from a previous search result'}}}
get_buyer_questions
Buyer questions for a VisibilityAI listing: owner-submitted industry questions mixed with VisibilityAI templates. Use when an agent needs the questions customers actually ask in this category, or to cite a business's public Q&A.
Input schema
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Optional city filter when searching by category'}, 'slug': {'type': 'string', 'description': 'Business slug. Prefer this when you already have a listing.'}, 'category': {'type': 'string', 'description': 'Category if you do not have a slug yet (e.g. Chartered Accountant)'}}}
get_category_leaders
Get the top-ranked businesses in a category across all cities. Useful for finding the globally recognized leaders. Ranking: Premium listings first, then Pro, then Basic, then Free, with visibility/GEO score breaking ties within each tier.
Input schema
{'type': 'object', 'required': ['category'], 'properties': {'topN': {'type': 'number', 'description': 'How many leaders to return (1 - 10). Default: 5.'}, 'category': {'type': 'string', 'description': 'Business category'}}}
get_lead_status
Check the status of a previously submitted lead by its ID.
Input schema
{'type': 'object', 'required': ['leadId'], 'properties': {'leadId': {'type': 'string', 'description': 'Lead ID returned by submit_lead'}}}
Output schema
{'type': 'object', 'properties': {'leadId': {'type': 'string'}, 'status': {'enum': ['new', 'contacted', 'closed'], 'type': 'string'}, 'submittedAt': {'type': 'string'}, 'businessName': {'type': 'string'}}}
get_listicle
Get VisibilityAI directory listings for a category+city. Order is VisibilityAI GEO score then name, not a paid placement and not a ChatGPT ranking. Use when the user asks for listed businesses in a category and city.
Input schema
{'type': 'object', 'required': ['category', 'city'], 'properties': {'city': {'type': 'string', 'description': 'City name'}, 'topN': {'type': 'number', 'description': 'How many entries to include (3 - 10). Default: 5.'}, 'category': {'type': 'string', 'description': 'Business category (e.g. CA, Dentist, Digital Agency)'}}}
get_my_citations
Requires a business-scoped API key (Authorization: Bearer header). Returns the authenticated business's recent real AI-platform check history (which engine, when, whether they were mentioned) - for a business owner's own agent, not for consumer discovery.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many recent checks to return (1 - 30). Default: 10.'}}}
Output schema
{'type': 'object', 'properties': {'total': {'type': 'number'}, 'checks': {'type': 'array', 'items': {'type': 'object'}}}}
get_my_intelligence_benchmark_status
Requires an API key (Authorization: Bearer header). Read-only: benchmark status from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_experiments
Requires an API key (Authorization: Bearer header). Read-only: experiments from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_items
Requires an API key (Authorization: Bearer header). Read-only: items from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_lineage
Requires an API key (Authorization: Bearer header). Read-only: lineage from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_overview
Requires an API key (Authorization: Bearer header). Read-only: overview from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_portfolio
Requires an API key (Authorization: Bearer header). Read-only: portfolio from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_intelligence_recommendations
Requires an API key (Authorization: Bearer header). Read-only: recommendations from your Intelligence Graph. Business keys read their own business; agency keys read an accepted client (pass businessId). Returns nothing that is not yours.
Input schema
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'enum': ['prompt', 'recommendation', 'action'], 'type': 'string'}, 'type': {'type': 'string'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'businessId': {'type': 'string', 'description': 'Agency keys only: the client business.'}}}
get_my_visibility_score
Requires a business-scoped API key (Authorization: Bearer header). Returns the authenticated business's own current AI visibility score and citation-rate summary - for a business owner's own agent checking on their own listing, not for consumer discovery. Get a key from the VisibilityAI dashboard's 'AI Agent Access' page.
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'properties': {'aiCitations': {'type': 'object'}, 'directoryCompletenessScore': {'type': 'number'}}}
get_offers
Get a business's real commerce offers - products/services with pricing, if the business has published a catalog. Use for shopping/pricing queries about a specific business you already have the slug for.
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Business slug from a previous search result'}}}
Output schema
{'type': 'object', 'properties': {'offers': {'type': 'array', 'items': {'type': 'object'}}, 'priceRange': {'type': 'string'}, 'availability': {'type': 'string'}}}
search_businesses
Search businesses listed on VisibilityAI worldwide by category, with an optional city filter. Use for queries like 'best accountant in London', 'top lawyers in Dubai', 'best GEO software', or 'dentists in New York'. City is optional - omit it for national/SaaS/product listings that are not tied to one city. Returns ranked results with contact details and AI descriptions. Ranking: Premium listings first, then Pro, then Basic, then Free, with visibility/GEO score breaking ties within each tier - disclosed in the response's rankingModel field. Listings include both owner-verified and unclaimed registry-sourced businesses; this tool does not filter by verification status.
Input schema
{'type': 'object', 'required': ['category'], 'properties': {'city': {'type': 'string', 'description': 'Optional city name (e.g. Mumbai, London, Dubai, New York, Gurgaon). Omit for product/SaaS or nationwide searches.'}, 'limit': {'type': 'number', 'description': 'Results to return (1 - 10). Default: 5.'}, 'category': {'type': 'string', 'description': 'Business type (e.g. CA, Chartered Accountant, Lawyer, Doctor, Dentist, Digital Agency, Restaurant, Gym, School, Architect, GEO Software)'}}}
Output schema
{'type': 'object', 'properties': {'total': {'type': 'number'}, 'browseUrl': {'type': 'string'}, 'businesses': {'type': 'array', 'items': {'type': 'object'}}}}
search_by_keyword
Free-text keyword search across business names, AI descriptions, services, USP, taglines, keywords, and buyer-question corpus.
Input schema
{'type': 'object', 'required': ['keyword'], 'properties': {'city': {'type': 'string', 'description': 'Optional: filter to a specific City name'}, 'limit': {'type': 'number', 'description': 'Results to return (1 - 10). Default: 5.'}, 'keyword': {'type': 'string', 'description': "Free-text search phrase (e.g. 'GST filing', 'wedding photography', 'React developer')"}}}
submit_lead
Submit a qualified lead to connect a user with a specific business - use this when the user has explicitly asked to be contacted or introduced. Requires an explicit consent attestation: only call this after the user has clearly agreed to be contacted about this request in this conversation. Do not call this speculatively or to 'try' a business on the user's behalf without that agreement.
Input schema
{'type': 'object', 'required': ['slug', 'userPhone', 'consentConfirmed', 'consentMethod'], 'properties': {'slug': {'type': 'string', 'description': 'Business slug from a previous search result'}, 'locale': {'type': 'string', 'description': 'Optional BCP-47 locale of the end user\'s conversation, e.g. "en-IN", "hi-IN", "hi-Latn-IN" (Hinglish). Improves the accuracy of the business\'s outcome tracking; never guessed if omitted.'}, 'queryId': {'type': 'string', 'description': 'Optional query/demand id when the lead is tied to a tracked buyer question.'}, 'userName': {'type': 'string', 'description': "User's name, if given"}, 'userPhone': {'type': 'string', 'description': "User's phone number, with country code (e.g. +91XXXXXXXXXX)"}, 'userQuery': {'type': 'string', 'description': 'What the user is looking for / their message to the business'}, 'consentMethod': {'type': 'string', 'description': 'Briefly describe how consent was obtained, e.g. "user asked to be connected with this business after reviewing its profile".'}, 'consentConfirmed': {'type': 'boolean', 'description': 'Must be true. Confirms the user explicitly agreed, in this conversation, to be contacted by this specific business.'}, 'externalRequestId': {'type': 'string', 'description': 'Optional stable request id from the calling agent. Retries with the same id and payload return the original lead instead of creating a duplicate.'}, 'serverCorrelationId': {'type': 'string', 'description': 'Optional correlation id returned by a prior submit_lead call. Reuse on retries when no externalRequestId is available.'}}}
Output schema
{'type': 'object', 'properties': {'leadId': {'type': 'string'}, 'status': {'enum': ['created', 'replayed'], 'type': 'string'}, 'message': {'type': 'string'}, 'success': {'type': 'boolean'}, 'businessName': {'type': 'string'}, 'externalRequestId': {'type': 'string'}, 'serverCorrelationId': {'type': 'string'}}}
Added
get_my_intelligence_portfolio
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_benchmark_status
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_experiments
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_recommendations
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_lineage
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_items
Sept. 25, 2026, 2:58 a.m.
Added
get_my_intelligence_overview
Sept. 25, 2026, 2:58 a.m.
Added
get_my_citations
Sept. 17, 2026, 12:52 p.m.
Added
get_my_visibility_score
Sept. 17, 2026, 12:52 p.m.
Added
get_offers
Sept. 17, 2026, 12:52 p.m.
Added
get_lead_status
Sept. 17, 2026, 12:52 p.m.
Added
submit_lead
Sept. 17, 2026, 12:52 p.m.
Added
get_available_cities
Sept. 17, 2026, 12:52 p.m.
Added
compare_businesses
Sept. 17, 2026, 12:52 p.m.
Added
get_listicle
Sept. 17, 2026, 12:52 p.m.
Added
get_buyer_questions
Sept. 17, 2026, 12:52 p.m.
Added
search_by_keyword
Sept. 17, 2026, 12:52 p.m.
Added
get_category_leaders
Sept. 17, 2026, 12:52 p.m.
Added
get_business_profile
Sept. 17, 2026, 12:52 p.m.
Added
search_businesses
Sept. 17, 2026, 12:52 p.m.