MCP Server

{
  "name": "code_search",
  "arguments": {
    "code": "tools.select { |t| t[:path].include?(\"products\") }.map { |t| \"#{t[:method]} #{t[:path]} — #{t[:summary]}\" }"
  }
}

{
  "result": [
    "GET /products — List products",
    "POST /products — Create product",
    "GET /products/{id} — Get product details",
    "PATCH /products/{id} — Update product",
    "DELETE /products/{id} — Delete product"
  ]
}

# List all available resource groups (tags)
tools.map { |t| t[:tags] }.flatten.compact.uniq.sort

# Find endpoints that accept a specific parameter
tools.select { |t| t[:parameters]&.any? { |p| p["name"] == "status" } }

# Count endpoints per tag
tools.group_by { |t| t[:tags]&.first }.transform_values(&:size)

# Get full details for a specific endpoint
tools.find { |t| t[:method] == "POST" && t[:path] == "/products" }

{
  "name": "code_execute",
  "arguments": {
    "code": "get(\"/products\")"
  }
}

# List products and get their names
products = get("/products")
products["data"].map { |p| p["name"] }

# Create a product, then a price variant (note creation order:
# a product needs a price variant before it can be set "active")
product = post("/products", name: "My Course", slug: "my-course", status: "draft")
post("/price_variants",
  product: product["id"],     # bare association name + prefix-id string, not product_id
  name: "Standard",
  amount_type: "fixed",
  amount: 4900,               # cents — $49.00
  currency: "usd",
  billing_type: "one_time"
)

# Cross-resource aggregation — 3 API calls, one round-trip
account = get("/account")
customers = get("/customers")
products = get("/products")
{
  account_name: account["name"],
  total_customers: customers["data"].size,
  total_products: products["data"].size,
  product_names: products["data"].map { |p| p["name"] }
}

# Batch update — update all active products in one shot
products = get("/products")["data"]
updated = products.select { |p| p["status"] == "active" }.map do |p|
  patch("/products/#{p['id']}", status: "archived")
  p["name"]
end
{ updated_count: updated.size, names: updated }