Servidor MCP

visibilityai

io.github.thinksuitesolution-coder/visibilityai
Marketing y publicidad Búsqueda e investigación Público y accesible MCP 2026-07-28

Qué hace este MCP

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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'type': 'object', 'required': ['leadId'], 'properties': {'leadId': {'type': 'string', 'description': 'Lead ID returned by submit_lead'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many recent checks to return (1 - 30). Default: 10.'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Business slug from a previous search result'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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)'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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'}}}
Añadido
get_my_intelligence_portfolio
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_benchmark_status
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_experiments
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_recommendations
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_lineage
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_items
25 de September de 2026 a las 02:58
Añadido
get_my_intelligence_overview
25 de September de 2026 a las 02:58
Añadido
get_my_citations
17 de September de 2026 a las 12:52
Añadido
get_my_visibility_score
17 de September de 2026 a las 12:52
Añadido
get_offers
17 de September de 2026 a las 12:52
Añadido
get_lead_status
17 de September de 2026 a las 12:52
Añadido
submit_lead
17 de September de 2026 a las 12:52
Añadido
get_available_cities
17 de September de 2026 a las 12:52
Añadido
compare_businesses
17 de September de 2026 a las 12:52
Añadido
get_listicle
17 de September de 2026 a las 12:52
Añadido
get_buyer_questions
17 de September de 2026 a las 12:52
Añadido
search_by_keyword
17 de September de 2026 a las 12:52
Añadido
get_category_leaders
17 de September de 2026 a las 12:52
Añadido
get_business_profile
17 de September de 2026 a las 12:52
Añadido
search_businesses
17 de September de 2026 a las 12:52