MCP-Server

visibilityai

io.github.thinksuitesolution-coder/visibilityai
Marketing & Werbung Suche & Recherche Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

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