ryuhq.com

{
  "name": "read_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read any page of the Ryu website (ryuhq.com) as markdown. Use this to answer questions about Ryu's product, pricing, documentation, or marketplace listings from the site's own current content rather than from memory. Takes a site-relative path such as '/pricing' or '/marketplace'.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "path": {
        "type": "string",
        "description": "Site-relative path to read, for example '/pricing'. Defaults to the site's home page."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "list_agent_skills",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the agent skills Ryu publishes — instruction documents that teach an AI agent how to set up a Ryu server, build an agent on it, install and serve a local model, or drive the server over MCP. Returns each skill's name, description, and the URL of its SKILL.md.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_marketplace",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the Ryu marketplace for installable plugins, skills, models, and MCP servers. Returns matching items with their id, kind, price, version, and description.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search, for example 'browser' or 'whisper'."
      },
      "kind": {
        "type": "string",
        "enum": [
          "app",
          "plugin",
          "skill",
          "model",
          "mcp",
          "agent",
          "stack_template",
          "workflow",
          "theme",
          "language_pack",
          "space",
          "profile",
          "output_style",
          "bundle"
        ],
        "description": "Restrict results to a single catalog kind."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_marketplace_item",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get one public Marketplace item's current name, description, version, price, and publisher details before deciding whether to start checkout.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "type": "string",
        "enum": [
          "app",
          "plugin",
          "skill",
          "model",
          "mcp",
          "agent",
          "stack_template",
          "workflow",
          "theme",
          "language_pack",
          "space",
          "profile",
          "output_style",
          "bundle"
        ],
        "description": "The item's catalog kind returned by search_marketplace."
      },
      "id": {
        "type": "string",
        "description": "The exact item id returned by search_marketplace."
      }
    },
    "required": [
      "kind",
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_cloud_instance_catalog",
  "kind": "answer",
  "impl": "imperative",
  "description": "List public Ryu Cloud shared-vCPU instance options with monthly prices, regional availability, and live or fallback catalog status. Use the exact type and location returned here before starting Cloud checkout.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "location": {
        "type": "string",
        "description": "Optional location id such as 'nbg1' to show availability for a specific region."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_marketplace_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Start a hosted checkout for one paid Ryu Marketplace item. The signed-in account, active organization, item price, seller, and billing step-up are checked by Ryu; the final payment is reviewed on Stripe. Do not use for free or already-owned items.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "type": "string",
        "enum": [
          "app",
          "plugin",
          "skill",
          "model",
          "mcp",
          "agent",
          "stack_template",
          "workflow",
          "theme",
          "language_pack",
          "space",
          "profile",
          "output_style",
          "bundle"
        ],
        "description": "The item's catalog kind returned by search_marketplace."
      },
      "id": {
        "type": "string",
        "description": "The exact paid item id returned by search_marketplace."
      }
    },
    "required": [
      "kind",
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_plan_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Start hosted checkout for a public Ryu plan. Ryu validates the signed-in account, active organization for Teams or Business, and billing step-up; the final amount is reviewed on Polar before payment.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "plan": {
        "type": "string",
        "enum": [
          "lifetime",
          "marketplace-membership-monthly",
          "marketplace-membership-yearly",
          "pro-monthly",
          "pro-yearly",
          "max-monthly",
          "max-yearly",
          "teams-monthly",
          "teams-yearly",
          "business-monthly",
          "business-yearly"
        ],
        "description": "The exact public plan slug from the pricing page."
      },
      "seats": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "description": "Optional Teams or Business seat count. The server checks it against organization members and plan limits."
      }
    },
    "required": [
      "plan"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_cloud_instance_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Start hosted checkout for one paid Ryu Cloud instance add-on. Use get_cloud_instance_catalog first. Ryu re-resolves the live instance type and price, active organization, billing role, entitlement, and billing step-up on the server; the final recurring amount is reviewed on Polar. The exact plan- and region-specific included node is not purchased here.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "description": "Exact instance type returned by get_cloud_instance_catalog, such as 'cpx11'."
      },
      "location": {
        "type": "string",
        "description": "Optional exact location id returned by get_cloud_instance_catalog. The server uses its default region when omitted."
      },
      "inferenceMode": {
        "type": "string",
        "enum": [
          "managed",
          "byok"
        ],
        "description": "Whether Ryu-managed inference or the organization's own provider setup is used on the node. This is a mode flag; never provide a provider key here."
      },
      "desktopEnabled": {
        "type": "boolean",
        "description": "Whether to install the managed Linux desktop and per-agent screens on the node."
      },
      "organizationId": {
        "type": "string",
        "description": "Optional organization id to bill and provision. The server re-checks that the signed-in caller can manage billing for it."
      }
    },
    "required": [
      "type"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_credit_topup",
  "kind": "act",
  "impl": "imperative",
  "description": "Start hosted checkout for a Ryu organization credit top-up. The caller must be an organization admin with managed inference; Ryu calculates the deposit fee and shows the final charge on Polar before payment.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "pack": {
        "type": "string",
        "enum": [
          "10",
          "25",
          "100"
        ],
        "description": "A fixed credit pack in whole USD, as 10, 25, or 100."
      },
      "amountCents": {
        "type": "integer",
        "minimum": 500,
        "maximum": 100000,
        "description": "Optional custom face value in cents, from 500 ($5) to 100000 ($1000). Pass this or pack, not both."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}