MCPサーバー

visibilityai

io.github.thinksuitesolution-coder/visibilityai

この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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'type': 'object', 'required': ['leadId'], 'properties': {'leadId': {'type': 'string', 'description': 'Lead ID returned by submit_lead'}}}
出力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many recent checks to return (1 - 30). Default: 10.'}}}
出力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'type': 'object', 'properties': {}}
出力スキーマ
{'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.
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Business slug from a previous search result'}}}
出力スキーマ
{'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.
入力スキーマ
{'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)'}}}
出力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.'}}}
出力スキーマ
{'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'}}}
追加
get_my_intelligence_portfolio
2026年9月25日2:58
追加
get_my_intelligence_benchmark_status
2026年9月25日2:58
追加
get_my_intelligence_experiments
2026年9月25日2:58
追加
get_my_intelligence_recommendations
2026年9月25日2:58
追加
get_my_intelligence_lineage
2026年9月25日2:58
追加
get_my_intelligence_items
2026年9月25日2:58
追加
get_my_intelligence_overview
2026年9月25日2:58
追加
get_my_citations
2026年9月17日12:52
追加
get_my_visibility_score
2026年9月17日12:52
追加
get_offers
2026年9月17日12:52
追加
get_lead_status
2026年9月17日12:52
追加
submit_lead
2026年9月17日12:52
追加
get_available_cities
2026年9月17日12:52
追加
compare_businesses
2026年9月17日12:52
追加
get_listicle
2026年9月17日12:52
追加
get_buyer_questions
2026年9月17日12:52
追加
search_by_keyword
2026年9月17日12:52
追加
get_category_leaders
2026年9月17日12:52
追加
get_business_profile
2026年9月17日12:52
追加
search_businesses
2026年9月17日12:52