BuyAPI

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.

{
  "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#"
}

{
  "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": {}
}

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.

{
  "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#"
}

{
  "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": {}
}

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.

{
  "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#"
}

{
  "type": "object",
  "properties": {
    "evidence": {
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "evidence"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

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.

{
  "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#"
}

{
  "type": "object",
  "properties": {
    "stacks": {
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "stacks"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

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.

{
  "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#"
}

{
  "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": {}
}

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.

{
  "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#"
}

{
  "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": {}
}

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.

{
  "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#"
}

{
  "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": {}
}