KeeperHub MCP API

openapi: 3.2.0
info:
  title: KeeperHub MCP API
  version: 1.0.0
  description: Web3 workflow automation platform. Workflows are callable by AI agents via REST or MCP.
  x-guidance: 'KeeperHub exposes workflows as REST endpoints under /api/mcp/workflows/{slug}/call.

    Each workflow has a slug, accepts a JSON body, and returns a JSON response with `executionId`, `status`, and `output`.

    Auth: paid workflows return HTTP 402 with x402/MPP payment info on the first call; pay (e.g. via agentcash, openclaw, or any x402 client) and replay. Free workflows can be called directly.

    Categories of workflows include: DeFi yield/risk reads (e.g. usdc-yield-rates-aave-vs-compound, aave-v3-health-check, defi-risk-snapshot), tipping primitives (microtip), and write-type workflows that return unsigned calldata for the caller to sign and broadcast.


    ## Worked examples


    ### Example 1: Compare USDC yield (paid, $0.01)

    POST /api/mcp/workflows/usdc-yield-rates-aave-vs-compound/call

    Body: {}

    Response (after payment): { executionId, status: "success", output: { result: { rates: [...], bestRate, bestProtocol } } }


    ### Example 2: Aave v3 health check (paid, $0.01)

    POST /api/mcp/workflows/aave-v3-health-check/call

    Body: { "address": "0x..." }

    Response (after payment): { executionId, status: "success", output: { result: { healthFactor, totalCollateralUSD, totalDebtUSD, riskLevel } } }


    ### Example 3: Discover available workflows (free)

    GET /api/mcp/workflows  (returns the list of all listed workflows + pricing)

    GET /openapi.json       (this document; full schema for every workflow)


    When in doubt, fetch /openapi.json and read the per-workflow `x-payment-info`, `security`, and `requestBody` fields.


    ## Errors, versioning, and rate limits


    Every failure returns the same envelope: `{ error, detail, hint?, docs?, request_id }`. Branch on `error` (a stable snake_case code) and never on `detail`. See `components.schemas.Error` and `x-error-model`.

    Pin a call to a version with the `KeeperHub-Version: 1` request header; omit it to track the current version. Breaking changes ship as a new version, announced with `Deprecation` and `Sunset` headers at least 180 days apart. See `x-api-versioning`.

    Limited endpoints return `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` (delta seconds), plus the legacy `X-RateLimit-*` spellings, and `Retry-After` on a 429. Self-throttle from those rather than backing off blindly.'
servers:
- url: https://app.keeperhub.com
tags:


# --- truncated at 32 KB (648 KB total) ---
# Full source: https://artifacts.apis.io/keeperhub-com/openapi/keeperhub-com-mcp-api-openapi.yml