Server definition

Hash: sha256:1779ee0315ea9434f300ccafadfb9d85e97e9c9a2cb6c8ac85888e093152b094
What it is: What a remote MCP server returned when asked what it offers: 7 tools

The blob, as servednamed by its sha256

{
  "instructions": "Use BuyAPI before choosing, installing, or replacing a software vendor in a project.\n\nIt is strongest for high-switching-cost stack decisions involving databases, auth, hosting, payments, email, analytics, and feature flags. Start with vendors.resolve when candidates are unknown, use vendors.compare when the user named options, and use stacks.recommend for a complete multi-layer stack decision. Use details, evidence, cost, and similar-stack tools only as follow-ups.\n\nDo not call BuyAPI for implementation syntax, debugging, or documentation lookup after a vendor has already been selected. Treat explicit unknown or stale coverage as a reason to verify first-party sources, not permission to guess.",
  "tools": [
    {
      "description": "Finds reviewed public stack examples related to a vendor, or recent curated stack examples.\n\nUse 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "limit": {
            "description": "Maximum stacks to return",
            "type": "number"
          },
          "vendorId": {
            "description": "Optional BuyAPI vendor ID, e.g. /database/convex",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "stacks.findSimilar",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "stacks": {
            "items": {},
            "type": "array"
          }
        },
        "required": [
          "stacks"
        ],
        "type": "object"
      }
    },
    {
      "description": "Recommends a complete stack from BuyAPI's corpus with a structured decision matrix, cost estimate, assumptions, unknowns, alternatives, and sources.\n\nUse 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "constraints": {
            "description": "Budget, scale, existing tools, team size, compliance needs",
            "type": "string"
          },
          "projectDescription": {
            "description": "What the user is building",
            "type": "string"
          },
          "stackContext": {
            "description": "Optional existing stack context from a repo scan or saved private stack. Agents should pass derived tool metadata only, not source code.",
            "items": {
              "properties": {
                "category": {
                  "description": "The role/category this tool fills",
                  "type": "string"
                },
                "confidence": {
                  "description": "Scanner or user confidence for this detected tool",
                  "type": "string"
                },
                "vendorSlug": {
                  "description": "BuyAPI vendor ID, e.g. /database/convex",
                  "type": "string"
                }
              },
              "required": [
                "vendorSlug",
                "category"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "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.",
            "properties": {
              "devWorkflow": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "frameworks": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "languages": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "packageManagers": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "runtimes": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "testing": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "workload": {
            "description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.",
            "properties": {
              "authMau": {
                "type": "number"
              },
              "averageTransactionUsd": {
                "type": "number"
              },
              "databaseSizeGb": {
                "type": "number"
              },
              "emailSendsPerMonth": {
                "type": "number"
              },
              "monthlyActiveUsers": {
                "type": "number"
              },
              "monthlyRevenueUsd": {
                "type": "number"
              },
              "monthlyTransactions": {
                "type": "number"
              },
              "notes": {
                "type": "string"
              },
              "regions": {
                "type": "number"
              },
              "storageGb": {
                "type": "number"
              },
              "teamSeats": {
                "type": "number"
              },
              "users": {
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "projectDescription"
        ],
        "type": "object"
      },
      "name": "stacks.recommend",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "alternativesConsidered": {
            "items": {},
            "type": "array"
          },
          "claims": {
            "items": {},
            "type": "array"
          },
          "costEstimate": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "coverage": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "decisionMatrix": {
            "items": {},
            "type": "array"
          },
          "sources": {
            "items": {},
            "type": "array"
          },
          "stack": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "unknowns": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Compares two or more already-known BuyAPI vendors for a specific workload or decision.\n\nUse 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "query": {
            "description": "The user's decision context",
            "type": "string"
          },
          "vendorIds": {
            "description": "BuyAPI vendor IDs, e.g. ['/database/convex', '/database/neon']",
            "items": {
              "type": "string"
            },
            "minItems": 2,
            "type": "array"
          },
          "workload": {
            "description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.",
            "properties": {
              "authMau": {
                "type": "number"
              },
              "averageTransactionUsd": {
                "type": "number"
              },
              "databaseSizeGb": {
                "type": "number"
              },
              "emailSendsPerMonth": {
                "type": "number"
              },
              "monthlyActiveUsers": {
                "type": "number"
              },
              "monthlyRevenueUsd": {
                "type": "number"
              },
              "monthlyTransactions": {
                "type": "number"
              },
              "notes": {
                "type": "string"
              },
              "regions": {
                "type": "number"
              },
              "storageGb": {
                "type": "number"
              },
              "teamSeats": {
                "type": "number"
              },
              "users": {
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "vendorIds",
          "query"
        ],
        "type": "object"
      },
      "name": "vendors.compare",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "availableCategories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "claims": {
            "items": {},
            "type": "array"
          },
          "coverage": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "decisionMatrix": {
            "items": {},
            "type": "array"
          },
          "kind": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "suggestedNextSteps": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Follow-up tool for one known vendor. Retrieves detailed pricing, features, limits, gotchas, comparisons, and source provenance.\n\nCall 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "query": {
            "description": "Specific question to focus the response on",
            "type": "string"
          },
          "vendorId": {
            "description": "BuyAPI vendor ID, e.g. /database/supabase",
            "type": "string"
          }
        },
        "required": [
          "vendorId"
        ],
        "type": "object"
      },
      "name": "vendors.details",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "claims": {
            "items": {},
            "type": "array"
          },
          "coverage": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "sources": {
            "items": {},
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Produces directional monthly cost estimates from BuyAPI pricing data and explicit workload inputs.\n\nUse 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "category": {
            "description": "Optional category to estimate across the current corpus",
            "type": "string"
          },
          "vendorIds": {
            "description": "Optional vendor IDs to estimate directly",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "workload": {
            "description": "Explicit workload assumptions for directional cost estimates. Missing fields become assumptions, not fabricated precision.",
            "properties": {
              "authMau": {
                "type": "number"
              },
              "averageTransactionUsd": {
                "type": "number"
              },
              "databaseSizeGb": {
                "type": "number"
              },
              "emailSendsPerMonth": {
                "type": "number"
              },
              "monthlyActiveUsers": {
                "type": "number"
              },
              "monthlyRevenueUsd": {
                "type": "number"
              },
              "monthlyTransactions": {
                "type": "number"
              },
              "notes": {
                "type": "string"
              },
              "regions": {
                "type": "number"
              },
              "storageGb": {
                "type": "number"
              },
              "teamSeats": {
                "type": "number"
              },
              "users": {
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "workload"
        ],
        "type": "object"
      },
      "name": "vendors.estimateCost",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "availableCategories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "claims": {
            "items": {},
            "type": "array"
          },
          "coverage": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "estimates": {
            "items": {},
            "type": "array"
          },
          "kind": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "suggestedNextSteps": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Returns recent reviewed BuyAPI evidence rows for a vendor, category, stack, or comparison.\n\nUse 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.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "limit": {
            "description": "Maximum rows to return",
            "type": "number"
          },
          "subjectId": {
            "description": "Subject ID, e.g. /database/supabase or database",
            "type": "string"
          },
          "subjectType": {
            "description": "Evidence subject type",
            "enum": [
              "vendor",
              "category",
              "stack",
              "comparison"
            ],
            "type": "string"
          }
        },
        "required": [
          "subjectType",
          "subjectId"
        ],
        "type": "object"
      },
      "name": "vendors.evidence",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "evidence": {
            "items": {},
            "type": "array"
          }
        },
        "required": [
          "evidence"
        ],
        "type": "object"
      }
    },
    {
      "description": "First stop for category-specific vendor recommendations and vendor ID discovery. Finds BuyAPI vendor IDs for a user question; provide category when known.\n\nUse 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.\nIf the category is outside BuyAPI's corpus, the tool returns an explicit \"not in corpus yet\" result instead of inventing vendors.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "category": {
            "description": "Optional category: database, auth, hosting, payments, email, analytics, feature-flags",
            "type": "string"
          },
          "query": {
            "description": "The user's question or task context for relevance ranking",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "vendors.resolve",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": {},
        "properties": {
          "availableCategories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "claims": {
            "items": {},
            "type": "array"
          },
          "coverage": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "decisionMatrix": {
            "items": {},
            "type": "array"
          },
          "kind": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "results": {
            "items": {},
            "type": "array"
          },
          "suggestedNextSteps": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:1779ee0315ea9434f300ccafadfb9d85e97e9c9a2cb6c8ac85888e093152b094 | sha256sum