Servidor MCP

BuyAPI

io.github.TheSnakeFang/buyapi-mcp

Qué hace este 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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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']"}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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': {}}
Añadido
stacks.recommend
17 de September de 2026 a las 12:52
Añadido
vendors.estimateCost
17 de September de 2026 a las 12:52
Añadido
vendors.compare
17 de September de 2026 a las 12:52
Añadido
stacks.findSimilar
17 de September de 2026 a las 12:52
Añadido
vendors.evidence
17 de September de 2026 a las 12:52
Añadido
vendors.details
17 de September de 2026 a las 12:52
Añadido
vendors.resolve
17 de September de 2026 a las 12:52