BuyAPI
Vendor intelligence for AI coding agents choosing developer tools and stacks.
Should I use this
Quality & Safety
Findings (7)
- LOWTool 'vendors.resolve' doesn't follow camelCase/snake_casein vendors.resolve
- LOWTool 'vendors.details' doesn't follow camelCase/snake_casein vendors.details
- LOWTool 'vendors.evidence' doesn't follow camelCase/snake_casein vendors.evidence
- LOWTool 'stacks.findSimilar' doesn't follow camelCase/snake_casein stacks.findSimilar
- LOWTool 'vendors.compare' doesn't follow camelCase/snake_casein vendors.compare
- LOWTool 'vendors.estimateCost' doesn't follow camelCase/snake_casein vendors.estimateCost
- LOWTool 'stacks.recommend' doesn't follow camelCase/snake_casein stacks.recommend
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"buyapi-mcp": {
"url": "https://buyapi.ai/api/mcp"
}
}
}Remote endpoints
https://buyapi.ai/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢vendors.resolve(query, category)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The user's question or task context for relevance ranking"
},
"category": {
"description": "Optional category: database, auth, hosting, payments, email, analytics, feature-flags",
"type": "string"
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {}
},
"decisionMatrix": {
"type": "array",
"items": {}
},
"claims": {
"type": "array",
"items": {}
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"kind": {
"type": "string"
},
"query": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestedNextSteps": {
"type": "array",
"items": {
"type": "string"
}
},
"availableCategories": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢vendors.details(vendorId, query)
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.
Input Schema
{
"type": "object",
"properties": {
"vendorId": {
"type": "string",
"description": "BuyAPI vendor ID, e.g. /database/supabase"
},
"query": {
"description": "Specific question to focus the response on",
"type": "string"
}
},
"required": [
"vendorId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {}
},
"claims": {
"type": "array",
"items": {}
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢vendors.evidence(subjectType, subjectId, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"subjectType": {
"type": "string",
"enum": [
"vendor",
"category",
"stack",
"comparison"
],
"description": "Evidence subject type"
},
"subjectId": {
"type": "string",
"description": "Subject ID, e.g. /database/supabase or database"
},
"limit": {
"description": "Maximum rows to return",
"type": "number"
}
},
"required": [
"subjectType",
"subjectId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"evidence": {
"type": "array",
"items": {}
}
},
"required": [
"evidence"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stacks.findSimilar(vendorId, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"vendorId": {
"description": "Optional BuyAPI vendor ID, e.g. /database/convex",
"type": "string"
},
"limit": {
"description": "Maximum stacks to return",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"stacks": {
"type": "array",
"items": {}
}
},
"required": [
"stacks"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢vendors.compare(vendorIds, query, workload)
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.
Input Schema
{
"type": "object",
"properties": {
"vendorIds": {
"minItems": 2,
"type": "array",
"items": {
"type": "string"
},
"description": "BuyAPI vendor IDs, e.g. ['/database/convex', '/database/neon']"
},
"query": {
"type": "string",
"description": "The user's decision context"
},
"workload": {
"type": "object",
"properties": {
"users": {
"type": "number"
},
"monthlyActiveUsers": {
"type": "number"
},
"storageGb": {
"type": "number"
},
"databaseSizeGb": {
"type": "number"
},
"emailSendsPerMonth": {
"type": "number"
},
"authMau": {
"type": "number"
},
"regions": {
"type": "number"
},
"teamSeats": {
"type": "number"
},
"monthlyTransactions": {
"type": "number"
},
"averageTransactionUsd": {
"type": "number"
},
"monthlyRevenueUsd": {
"type": "number"
},
"notes": {
"type": "string"
}
},
"description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision."
}
},
"required": [
"vendorIds",
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"decisionMatrix": {
"type": "array",
"items": {}
},
"claims": {
"type": "array",
"items": {}
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"kind": {
"type": "string"
},
"query": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestedNextSteps": {
"type": "array",
"items": {
"type": "string"
}
},
"availableCategories": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢vendors.estimateCost(vendorIds, category, workload)
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.
Input Schema
{
"type": "object",
"properties": {
"vendorIds": {
"description": "Optional vendor IDs to estimate directly",
"type": "array",
"items": {
"type": "string"
}
},
"category": {
"description": "Optional category to estimate across the current corpus",
"type": "string"
},
"workload": {
"type": "object",
"properties": {
"users": {
"type": "number"
},
"monthlyActiveUsers": {
"type": "number"
},
"storageGb": {
"type": "number"
},
"databaseSizeGb": {
"type": "number"
},
"emailSendsPerMonth": {
"type": "number"
},
"authMau": {
"type": "number"
},
"regions": {
"type": "number"
},
"teamSeats": {
"type": "number"
},
"monthlyTransactions": {
"type": "number"
},
"averageTransactionUsd": {
"type": "number"
},
"monthlyRevenueUsd": {
"type": "number"
},
"notes": {
"type": "string"
}
},
"description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision."
}
},
"required": [
"workload"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"estimates": {
"type": "array",
"items": {}
},
"claims": {
"type": "array",
"items": {}
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"kind": {
"type": "string"
},
"query": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestedNextSteps": {
"type": "array",
"items": {
"type": "string"
}
},
"availableCategories": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stacks.recommend(projectDescription, constraints, workload, stackContext, stackFacts)
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.
Input Schema
{
"type": "object",
"properties": {
"projectDescription": {
"type": "string",
"description": "What the user is building"
},
"constraints": {
"description": "Budget, scale, existing tools, team size, compliance needs",
"type": "string"
},
"workload": {
"type": "object",
"properties": {
"users": {
"type": "number"
},
"monthlyActiveUsers": {
"type": "number"
},
"storageGb": {
"type": "number"
},
"databaseSizeGb": {
"type": "number"
},
"emailSendsPerMonth": {
"type": "number"
},
"authMau": {
"type": "number"
},
"regions": {
"type": "number"
},
"teamSeats": {
"type": "number"
},
"monthlyTransactions": {
"type": "number"
},
"averageTransactionUsd": {
"type": "number"
},
"monthlyRevenueUsd": {
"type": "number"
},
"notes": {
"type": "string"
}
},
"description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision."
},
"stackContext": {
"description": "Optional existing stack context from a repo scan or saved private stack. Agents should pass derived tool metadata only, not source code.",
"type": "array",
"items": {
"type": "object",
"properties": {
"vendorSlug": {
"type": "string",
"description": "BuyAPI vendor ID, e.g. /database/convex"
},
"category": {
"type": "string",
"description": "The role/category this tool fills"
},
"confidence": {
"description": "Scanner or user confidence for this detected tool",
"type": "string"
}
},
"required": [
"vendorSlug",
"category"
]
}
},
"stackFacts": {
"description": "Optional derived stack facts such as languages, frameworks, runtimes, package managers, test tools, and dev workflow. Do not pass source code or secrets.",
"type": "object",
"properties": {
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"runtimes": {
"type": "array",
"items": {
"type": "string"
}
},
"packageManagers": {
"type": "array",
"items": {
"type": "string"
}
},
"testing": {
"type": "array",
"items": {
"type": "string"
}
},
"devWorkflow": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"projectDescription"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"stack": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"decisionMatrix": {
"type": "array",
"items": {}
},
"costEstimate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"alternativesConsidered": {
"type": "array",
"items": {}
},
"unknowns": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "array",
"items": {}
},
"claims": {
"type": "array",
"items": {}
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}Community
Evidence