MCP Server

BuyAPI

io.github.TheSnakeFang/buyapi-mcp
Business & Operations Developer Tools Public & reachable MCP 2025-11-25

What this MCP does

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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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']"}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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.
Read only Open world Idempotent
Input schema
{'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'}}}
Output schema
{'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': {}}
Added
stacks.recommend
Sept. 17, 2026, 12:52 p.m.
Added
vendors.estimateCost
Sept. 17, 2026, 12:52 p.m.
Added
vendors.compare
Sept. 17, 2026, 12:52 p.m.
Added
stacks.findSimilar
Sept. 17, 2026, 12:52 p.m.
Added
vendors.evidence
Sept. 17, 2026, 12:52 p.m.
Added
vendors.details
Sept. 17, 2026, 12:52 p.m.
Added
vendors.resolve
Sept. 17, 2026, 12:52 p.m.