feat(keeperhub): add skill for web3 workflow automation via x402#11
Open
eskp wants to merge 1 commit into
Open
feat(keeperhub): add skill for web3 workflow automation via x402#11eskp wants to merge 1 commit into
eskp wants to merge 1 commit into
Conversation
Adds a skill for the KeeperHub bazaar at https://app.keeperhub.com — a web3 workflow-automation platform exposing DeFi reads, on-chain checks, and tipping primitives as named workflows under /api/mcp/workflows/{slug}/call, payable per call via x402 (USDC on Base). Covers (CLI + MCP variants, mirroring existing skill conventions): - skills/keeperhub/ + mcp/skills/keeperhub/ — Quick Reference, worked examples for usdc-yield-rates-aave-vs-compound, aave-v3-health-check, and microtip; failure modes; getting-started.md - SERVICES + Available Services additions in skills/agentcash/SKILL.md, mcp/skills/agentcash-wallet/SKILL.md, and plugin/skills/agentcash/SKILL.md so the curated preamble surfaces KeeperHub for relevant tasks - TRIGGERS additions: web3, defi, on-chain Verified against the live KeeperHub OpenAPI spec (https://app.keeperhub.com/openapi.json): - workflow paths and the {executionId, status, output: {result}} envelope - aave-v3-health-check input/output shape - usdc-yield-rates-aave-vs-compound input shape ({}) and output keys microtip's exact request body isn't declared in /openapi.json yet (workflow-side gap, not a skill issue); the skill directs callers to check_endpoint_schema before calling rather than inventing a shape.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a skill for KeeperHub (https://app.keeperhub.com) — a web3 workflow-automation platform that exposes DeFi reads, on-chain checks, and tipping primitives as named workflows callable via x402 (USDC on Base, $0.01 typical for reads).
skills/keeperhub/skills/email/shape)mcp/skills/keeperhub/skills/agentcash/SKILL.mdkeeperhubto SERVICES + Available Services table; addweb3, defi, on-chainto TRIGGERSmcp/skills/agentcash-wallet/SKILL.mdplugin/skills/agentcash/SKILL.mdWhy now
KeeperHub just hardened its OpenAPI spec for x402/agentcash bazaar discoverability (KeeperHub#1077) — every workflow now declares canonical
x-payment-info,extensions.bazaar.schema.{input,output},security: []on free routes, and a worked-examples block ininfo.x-guidance. With the spec corrected, KeeperHub now satisfies the same shape that the curated agentcash preamble assumes, so adding it to SERVICES gives agents a discoverable origin for web3 tasks (currently no listed origin covers DeFi / on-chain).Workflows surfaced
The
Quick Referencetable in the new skill lists the live workflows:/api/mcp/workflows/openapi.json/api/mcp/workflows/usdc-yield-rates-aave-vs-compound/call/api/mcp/workflows/aave-v3-health-check/call/api/mcp/workflows/microtip/callVerification
Verified against the live KeeperHub OpenAPI spec at https://app.keeperhub.com/openapi.json:
/api/mcp/workflows/{slug}/call) and response envelope ({executionId, status, output: {result}}) match the canonical spec.aave-v3-health-checkinput ({address}) and output keys (healthFactor,totalCollateralUSD,totalDebtUSD,riskLevel) match.usdc-yield-rates-aave-vs-compoundinput shape ({}) and top-level output keys (rates,bestRate,bestProtocol) match.Endpoints exercised live (paid settlement on Base) before this PR: ~$0.04 across the three workflows above. All settlements succeeded; the pricing in the table reflects the real
x-payment-info.priceon each route.Notes for reviewers
/openapi.jsonyet (workflow-side gap on KeeperHub's end, separate from this PR). Rather than invent an example body, the skill directs callers tocheck_endpoint_schema(MCP) /npx agentcash@latest check(CLI) first. The KeeperHub team has been notified and a backfill is on their side.plugin/variant only ships theagentcashmeta-skill (no per-service skill dirs), matching existing convention — so noplugin/skills/keeperhub/is added.SKILL.md+rules/getting-started.md, mirrored tomcp/skills/.Structure
Plus 3-line additions to each of the three top-level
agentcashSKILL.md files.