Serveur MCP

BuyAPI

io.github.TheSnakeFang/buyapi-mcp
Entreprise et opérations Outils développeur Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Provides vendor discovery, comparisons, stack recommendations, pricing estimates, detailed vendor information, and supporting evidence for software and infrastructure choices.

stacks.findSimilar
Finds reviewed public stack examples related to a vendor, or recent curated stack examples. Use this when the user asks who uses a tool, what similar builders use, or wants examples of real stack combinations. Do not use it as a generic recommendation tool.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'description': 'Maximum stacks to return'}, 'vendorId': {'type': 'string', 'description': 'Optional BuyAPI vendor ID, e.g. /database/convex'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stacks'], 'properties': {'stacks': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
stacks.recommend
Recommends a complete stack from BuyAPI's corpus with a structured decision matrix, cost estimate, assumptions, unknowns, alternatives, and sources. Use this when the user is starting a project or asks for a complete multi-layer stack choice. Do not use this for local coding/debugging/docs questions that do not involve software or vendor selection. Do not call vendors.resolve first; this tool handles retrieval and ranking.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectDescription'], 'properties': {'workload': {'type': 'object', 'properties': {'notes': {'type': 'string'}, 'users': {'type': 'number'}, 'authMau': {'type': 'number'}, 'regions': {'type': 'number'}, 'storageGb': {'type': 'number'}, 'teamSeats': {'type': 'number'}, 'databaseSizeGb': {'type': 'number'}, 'monthlyRevenueUsd': {'type': 'number'}, 'emailSendsPerMonth': {'type': 'number'}, 'monthlyActiveUsers': {'type': 'number'}, 'monthlyTransactions': {'type': 'number'}, 'averageTransactionUsd': {'type': 'number'}}, 'description': 'Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.'}, 'stackFacts': {'type': 'object', 'properties': {'testing': {'type': 'array', 'items': {'type': 'string'}}, 'runtimes': {'type': 'array', 'items': {'type': 'string'}}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'frameworks': {'type': 'array', 'items': {'type': 'string'}}, 'devWorkflow': {'type': 'array', 'items': {'type': 'string'}}, 'packageManagers': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'Optional derived stack facts such as languages, frameworks, runtimes, package managers, test tools, and dev workflow. Do not pass source code or secrets.'}, 'constraints': {'type': 'string', 'description': 'Budget, scale, existing tools, team size, compliance needs'}, 'stackContext': {'type': 'array', 'items': {'type': 'object', 'required': ['vendorSlug', 'category'], 'properties': {'category': {'type': 'string', 'description': 'The role/category this tool fills'}, 'confidence': {'type': 'string', 'description': 'Scanner or user confidence for this detected tool'}, 'vendorSlug': {'type': 'string', 'description': 'BuyAPI vendor ID, e.g. /database/convex'}}}, 'description': 'Optional existing stack context from a repo scan or saved private stack. Agents should pass derived tool metadata only, not source code.'}, 'projectDescription': {'type': 'string', 'description': 'What the user is building'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'stack': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'claims': {'type': 'array', 'items': {}}, 'sources': {'type': 'array', 'items': {}}, 'coverage': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'unknowns': {'type': 'array', 'items': {'type': 'string'}}, 'costEstimate': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'decisionMatrix': {'type': 'array', 'items': {}}, 'alternativesConsidered': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
vendors.compare
Compares two or more already-known BuyAPI vendors for a specific workload or decision. Use this when the candidate set is known, for head-to-head questions like "Convex vs Supabase vs Neon for a realtime SaaS" or "Stripe vs Paddle for a marketplace". If the user has not named candidates, use vendors.resolve first.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vendorIds', 'query'], 'properties': {'query': {'type': 'string', 'description': "The user's decision context"}, 'workload': {'type': 'object', 'properties': {'notes': {'type': 'string'}, 'users': {'type': 'number'}, 'authMau': {'type': 'number'}, 'regions': {'type': 'number'}, 'storageGb': {'type': 'number'}, 'teamSeats': {'type': 'number'}, 'databaseSizeGb': {'type': 'number'}, 'monthlyRevenueUsd': {'type': 'number'}, 'emailSendsPerMonth': {'type': 'number'}, 'monthlyActiveUsers': {'type': 'number'}, 'monthlyTransactions': {'type': 'number'}, 'averageTransactionUsd': {'type': 'number'}}, 'description': 'Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.'}, 'vendorIds': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 2, 'description': "BuyAPI vendor IDs, e.g. ['/database/convex', '/database/neon']"}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'type': 'string'}, 'query': {'type': 'string'}, 'claims': {'type': 'array', 'items': {}}, 'message': {'type': 'string'}, 'coverage': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'decisionMatrix': {'type': 'array', 'items': {}}, 'suggestedNextSteps': {'type': 'array', 'items': {'type': 'string'}}, 'availableCategories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
vendors.details
Follow-up tool for one known vendor. Retrieves detailed pricing, features, limits, gotchas, comparisons, and source provenance. Call vendors.resolve first unless the user already provided a BuyAPI vendor ID like /database/supabase. Use this after a candidate is selected and the user needs claim-level pricing, limit, gotcha, or provenance details.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vendorId'], 'properties': {'query': {'type': 'string', 'description': 'Specific question to focus the response on'}, 'vendorId': {'type': 'string', 'description': 'BuyAPI vendor ID, e.g. /database/supabase'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'claims': {'type': 'array', 'items': {}}, 'sources': {'type': 'array', 'items': {}}, 'coverage': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
vendors.estimateCost
Produces directional monthly cost estimates from BuyAPI pricing data and explicit workload inputs. Use this only when the user asks for cost math and provides explicit workload inputs. Missing workload fields are returned as assumptions or unknowns instead of being hallucinated. Treat results as BuyAPI claim-based estimate math; verify exact billing in first-party docs, vendor CLIs, or vendor MCPs before purchase or production decisions.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['workload'], 'properties': {'category': {'type': 'string', 'description': 'Optional category to estimate across the current corpus'}, 'workload': {'type': 'object', 'properties': {'notes': {'type': 'string'}, 'users': {'type': 'number'}, 'authMau': {'type': 'number'}, 'regions': {'type': 'number'}, 'storageGb': {'type': 'number'}, 'teamSeats': {'type': 'number'}, 'databaseSizeGb': {'type': 'number'}, 'monthlyRevenueUsd': {'type': 'number'}, 'emailSendsPerMonth': {'type': 'number'}, 'monthlyActiveUsers': {'type': 'number'}, 'monthlyTransactions': {'type': 'number'}, 'averageTransactionUsd': {'type': 'number'}}, 'description': 'Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.'}, 'vendorIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional vendor IDs to estimate directly'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'type': 'string'}, 'query': {'type': 'string'}, 'claims': {'type': 'array', 'items': {}}, 'message': {'type': 'string'}, 'coverage': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'estimates': {'type': 'array', 'items': {}}, 'suggestedNextSteps': {'type': 'array', 'items': {'type': 'string'}}, 'availableCategories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
vendors.evidence
Returns recent reviewed BuyAPI evidence rows for a vendor, category, stack, or comparison. Use this when the user asks why BuyAPI believes something, what sources support a recommendation, or what recent human/source/opinion/history signals exist. This is a trust and provenance follow-up, not the first recommendation tool.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subjectType', 'subjectId'], 'properties': {'limit': {'type': 'number', 'description': 'Maximum rows to return'}, 'subjectId': {'type': 'string', 'description': 'Subject ID, e.g. /database/supabase or database'}, 'subjectType': {'enum': ['vendor', 'category', 'stack', 'comparison'], 'type': 'string', 'description': 'Evidence subject type'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['evidence'], 'properties': {'evidence': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
vendors.resolve
First stop for category-specific vendor recommendations and vendor ID discovery. Finds BuyAPI vendor IDs for a user question; provide category when known. Use this when the user asks which provider in a category fits their constraints. With a covered category, the response includes ranked results plus a top-3 decision matrix with fit labels, confidence, tradeoffs, cost notes, freshness, and sources. Do not use this for local coding/debugging/docs questions unless they involve choosing a software vendor or tool. If the category is outside BuyAPI's corpus, the tool returns an explicit "not in corpus yet" result instead of inventing vendors.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "The user's question or task context for relevance ranking"}, 'category': {'type': 'string', 'description': 'Optional category: database, auth, hosting, payments, email, analytics, feature-flags'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'type': 'string'}, 'query': {'type': 'string'}, 'claims': {'type': 'array', 'items': {}}, 'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {}}, 'coverage': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'decisionMatrix': {'type': 'array', 'items': {}}, 'suggestedNextSteps': {'type': 'array', 'items': {'type': 'string'}}, 'availableCategories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
Ajouté
stacks.recommend
17 September 2026 12:52
Ajouté
vendors.estimateCost
17 September 2026 12:52
Ajouté
vendors.compare
17 September 2026 12:52
Ajouté
stacks.findSimilar
17 September 2026 12:52
Ajouté
vendors.evidence
17 September 2026 12:52
Ajouté
vendors.details
17 September 2026 12:52
Ajouté
vendors.resolve
17 September 2026 12:52