diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 37497e1..a191349 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,8 +1,8 @@ { "name": "agentkit", "owner": { - "name": "Yield.xyz Agent", - "email": "" + "name": "Yield.xyz", + "url": "https://yield.xyz" }, "metadata": { "description": "Open source Claude Code skills for Yield.xyz & Web3 developers", diff --git a/.grok-plugin/marketplace.json b/.grok-plugin/marketplace.json new file mode 100644 index 0000000..3fc05ed --- /dev/null +++ b/.grok-plugin/marketplace.json @@ -0,0 +1,65 @@ +{ + "name": "agentkit", + "description": "Open source Yield.xyz AgentKit plugins and skills for Web3 developers", + "owner": { + "name": "Yield.xyz", + "url": "https://yield.xyz" + }, + "plugins": [ + { + "name": "yield-xyz-agentkit", + "description": "Discover and manage on-chain yield opportunities using the Yield.xyz API — find yields, build transactions, and check balances across 80+ networks. The base plugin.", + "category": "development", + "version": "1.0.0", + "source": { "type": "local", "path": "./plugins/yield-xyz-agentkit" }, + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "keywords": ["yield.xyz", "yield xyz", "yield agentkit", "stakekit"], + "domains": ["yield.xyz", "docs.yield.xyz", "mcp.yield.xyz", "dashboard.yield.xyz"] + }, + { + "name": "yield-xyz-agentkit-builder", + "description": "Build applications that integrate the Yield.xyz API — generate integration code for DeFi yield across 80+ networks.", + "category": "development", + "version": "1.0.0", + "source": { "type": "local", "path": "./plugins/yield-xyz-agentkit-builder" }, + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "keywords": ["yield.xyz", "yield xyz", "yield.xyz api", "yield agentkit"], + "domains": ["yield.xyz", "docs.yield.xyz", "api.yield.xyz", "dashboard.yield.xyz"] + }, + { + "name": "yield-xyz-agentkit-privy", + "description": "The Privy connector — sign and broadcast Yield.xyz transactions via Privy agentic wallets. Builds on the yield-xyz-agentkit base plugin.", + "category": "development", + "version": "1.0.0", + "source": { "type": "local", "path": "./plugins/yield-xyz-agentkit-privy" }, + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "keywords": ["yield.xyz", "yield xyz privy", "yield agentkit privy"], + "domains": ["yield.xyz", "docs.yield.xyz"] + }, + { + "name": "yield-xyz-agentkit-moonpay", + "description": "The MoonPay connector — sign and broadcast Yield.xyz transactions via MoonPay. Builds on the yield-xyz-agentkit base plugin.", + "category": "development", + "version": "1.0.0", + "source": { "type": "local", "path": "./plugins/yield-xyz-agentkit-moonpay" }, + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "keywords": ["yield.xyz", "yield xyz moonpay", "yield agentkit moonpay"], + "domains": ["yield.xyz", "docs.yield.xyz"] + }, + { + "name": "yield-xyz-agentkit-robinhood", + "description": "The Robinhood Chain connector — configure Robinhood Chain (mainnet, chain ID 4663) and act on Yield.xyz yields there. Builds on the yield-xyz-agentkit base plugin.", + "category": "development", + "version": "1.1.0", + "source": { "type": "local", "path": "./plugins/yield-xyz-agentkit-robinhood" }, + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "keywords": ["yield.xyz", "yield xyz robinhood", "yield agentkit robinhood"], + "domains": ["yield.xyz", "docs.yield.xyz"] + } + ] +} diff --git a/README.md b/README.md index ff3f066..2f83ec6 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ ![Yield.xyz AgentKit Banner](./assets/yield-xyz-agentkit-banner.png) -# Yield.xyz AgentKit — Claude Plugin & Skills +# Yield.xyz AgentKit — Claude & Grok Plugins & Skills [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-orange)](https://claude.ai/code) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-orange)](https://claude.ai/code) [![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/stakekit/agentkit) -The official tooling for Yield.xyz AgentKit — a Claude Code plugin, standalone skills, and connection guides for the Yield.xyz AgentKit MCP Server. +The official tooling for Yield.xyz AgentKit — plugins for Claude Code and Grok Build, standalone skills, and connection guides for the Yield.xyz AgentKit MCP Server. --- @@ -43,11 +43,30 @@ npx skills add https://github.com/stakekit/agentkit See **[`plugins/README.md`](./plugins/README.md)** for the per-plugin breakdown, individual skill descriptions, and a feature comparison. + +### Yield.xyz AgentKit Grok Build Plugins + +The same five plugins install into [Grok Build](https://docs.x.ai/build). Register this repo as a marketplace source in `~/.grok/config.toml`: + +```toml +[[marketplace.sources]] +name = "agentkit" +git = "https://github.com/stakekit/agentkit.git" +``` + +Then browse and install with `/marketplace` in the Grok TUI (press `i` on an entry), or install the base plugin straight from the repo: + +```bash +grok plugin install stakekit/agentkit#plugins/yield-xyz-agentkit --trust +``` + +The other four plugins install the same way — swap the plugin name at the end of the path. `--trust` is required for Grok to activate a plugin's skills and MCP servers. The base and builder plugins register the Yield.xyz MCP automatically; the connectors expect the base plugin alongside them. + --- ### Yield.xyz AgentKit MCP Server -The Yield.xyz AgentKit MCP Server exposes a suite of tools that give Claude live access to on-chain yield data, transaction building, and portfolio management across 80+ networks. +The Yield.xyz AgentKit MCP Server exposes a suite of tools that give your agent live access to on-chain yield data, transaction building, and portfolio management across 80+ networks. **Endpoint:** `https://mcp.yield.xyz/mcp` @@ -72,6 +91,23 @@ Add to `claude_desktop_config.json` (**Settings → Developer → Edit Config**) } ``` +### Option 3: Connect via Grok Build + +Installing the `yield-xyz-agentkit` plugin with `--trust` registers the MCP for you. To wire it up without the plugin, drop a `.mcp.json` in your project: + +```json +{ + "mcpServers": { + "yield-xyz-agentkit": { + "type": "http", + "url": "https://mcp.yield.xyz/mcp" + } + } +} +``` + +Or add it interactively with `grok mcp add` (see `grok mcp add --help`) and manage it from `/mcps` in the TUI. + → [Full connection guide and all methods](https://docs.yield.xyz/docs/mcp-server) --- diff --git a/plugins/README.md b/plugins/README.md index 99ff50a..eeebec3 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -1,11 +1,17 @@ # Yield.xyz AgentKit — Plugins -Five composable Claude Code plugins. Each ships one skill; the base and builder auto-register the Yield.xyz MCP, while the connectors (Privy, MoonPay, Robinhood Chain) **depend on** the base and inherit its MCP (MoonPay also needs the MoonPay MCP via guided setup). +Five composable plugins for Claude Code and Grok Build. Each ships one skill; the base and builder auto-register the Yield.xyz MCP, while the connectors (Privy, MoonPay, Robinhood Chain) **depend on** the base and inherit its MCP (MoonPay also needs the MoonPay MCP via guided setup). ```bash /plugin marketplace add stakekit/agentkit ``` +The `/plugin` commands below are Claude Code. In Grok Build, install the same plugin with: + +```bash +grok plugin install stakekit/agentkit#plugins/ --trust +``` + --- ## Plugins diff --git a/plugins/yield-xyz-agentkit-builder/.grok-plugin/plugin.json b/plugins/yield-xyz-agentkit-builder/.grok-plugin/plugin.json new file mode 100644 index 0000000..415ab52 --- /dev/null +++ b/plugins/yield-xyz-agentkit-builder/.grok-plugin/plugin.json @@ -0,0 +1,10 @@ +{ + "name": "yield-xyz-agentkit-builder", + "version": "1.0.0", + "description": "Build applications that integrate the Yield.xyz API — generate integration code for DeFi yield across 80+ networks.", + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "repository": "https://github.com/stakekit/agentkit", + "license": "MIT", + "keywords": ["yield.xyz", "yield api", "defi", "sdk", "developer", "integration", "web3"] +} diff --git a/plugins/yield-xyz-agentkit-moonpay/.grok-plugin/plugin.json b/plugins/yield-xyz-agentkit-moonpay/.grok-plugin/plugin.json new file mode 100644 index 0000000..1bdb1c0 --- /dev/null +++ b/plugins/yield-xyz-agentkit-moonpay/.grok-plugin/plugin.json @@ -0,0 +1,10 @@ +{ + "name": "yield-xyz-agentkit-moonpay", + "version": "1.0.0", + "description": "The MoonPay connector — sign and broadcast Yield.xyz transactions via MoonPay. Requires the yield-xyz-agentkit plugin — install it too.", + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "repository": "https://github.com/stakekit/agentkit", + "license": "MIT", + "keywords": ["yield.xyz", "moonpay", "wallet", "signing", "defi", "yield", "web3"] +} diff --git a/plugins/yield-xyz-agentkit-privy/.grok-plugin/plugin.json b/plugins/yield-xyz-agentkit-privy/.grok-plugin/plugin.json new file mode 100644 index 0000000..901abe7 --- /dev/null +++ b/plugins/yield-xyz-agentkit-privy/.grok-plugin/plugin.json @@ -0,0 +1,10 @@ +{ + "name": "yield-xyz-agentkit-privy", + "version": "1.0.0", + "description": "The Privy connector — sign and broadcast Yield.xyz transactions via Privy agentic wallets. Requires the yield-xyz-agentkit plugin — install it too.", + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "repository": "https://github.com/stakekit/agentkit", + "license": "MIT", + "keywords": ["yield.xyz", "privy", "agentic wallet", "signing", "defi", "yield", "web3"] +} diff --git a/plugins/yield-xyz-agentkit-robinhood/.grok-plugin/plugin.json b/plugins/yield-xyz-agentkit-robinhood/.grok-plugin/plugin.json new file mode 100644 index 0000000..e4aff5b --- /dev/null +++ b/plugins/yield-xyz-agentkit-robinhood/.grok-plugin/plugin.json @@ -0,0 +1,10 @@ +{ + "name": "yield-xyz-agentkit-robinhood", + "version": "1.1.0", + "description": "The Robinhood Chain connector — configure Robinhood Chain (mainnet, chain ID 4663) and act on Yield.xyz yields there. Requires the yield-xyz-agentkit plugin — install it too.", + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "repository": "https://github.com/stakekit/agentkit", + "license": "MIT", + "keywords": ["yield.xyz", "robinhood chain", "robinhood", "evm", "mainnet", "defi", "yield", "web3"] +} diff --git a/plugins/yield-xyz-agentkit/.grok-plugin/plugin.json b/plugins/yield-xyz-agentkit/.grok-plugin/plugin.json new file mode 100644 index 0000000..10ce696 --- /dev/null +++ b/plugins/yield-xyz-agentkit/.grok-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "name": "yield-xyz-agentkit", + "version": "1.0.0", + "description": "Discover and manage on-chain yield opportunities using the Yield.xyz API — find yields, build transactions, and check balances across 80+ networks. The base plugin.", + "author": { "name": "Yield.xyz", "url": "https://yield.xyz" }, + "homepage": "https://docs.yield.xyz", + "repository": "https://github.com/stakekit/agentkit", + "license": "MIT", + "keywords": ["yield.xyz", "yield", "defi", "staking", "lending", "apy", "web3", "ethereum", "solana"], + "logo": "assets/logo.png" +} diff --git a/plugins/yield-xyz-agentkit/.mcp.json b/plugins/yield-xyz-agentkit/.mcp.json index 043b6a7..7fb27e0 100644 --- a/plugins/yield-xyz-agentkit/.mcp.json +++ b/plugins/yield-xyz-agentkit/.mcp.json @@ -1,8 +1,8 @@ { "mcpServers": { "yield-xyz-agentkit": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.yield.xyz/mcp"] + "type": "http", + "url": "https://mcp.yield.xyz/mcp" } } } diff --git a/plugins/yield-xyz-agentkit/README.md b/plugins/yield-xyz-agentkit/README.md new file mode 100644 index 0000000..2630f5b --- /dev/null +++ b/plugins/yield-xyz-agentkit/README.md @@ -0,0 +1,61 @@ +# Yield.xyz AgentKit — Base plugin + +Discover and manage on-chain yield opportunities across 80+ networks. Find and compare yields, check balances and rewards, and build transactions for staking, lending, vaults, restaking, and liquidity pools. + +## What it ships + +| Component | Detail | +|---|---| +| Skill | `yield-xyz-agentkit` — routing logic, validator selection, transaction ordering, and safety checks | +| MCP server | `yield-xyz-agentkit` → `https://mcp.yield.xyz/mcp` (Streamable HTTP) | + +No commands, agents, hooks, or LSP servers. + +## Install + +Grok Build: + +```bash +grok plugin install stakekit/agentkit#plugins/yield-xyz-agentkit --trust +``` + +Claude Code: + +```bash +/plugin marketplace add stakekit/agentkit +/plugin install yield-xyz-agentkit@agentkit +``` + +## Configuration + +The MCP server works without configuration — discovery and diligence tools are open. For authenticated use, supply your own Yield.xyz API key as an `x-api-key` header: + +```json +{ + "mcpServers": { + "yield-xyz-agentkit": { + "type": "http", + "url": "https://mcp.yield.xyz/mcp", + "headers": { "x-api-key": "" } + } + } +} +``` + +Get a key at [dashboard.yield.xyz](https://dashboard.yield.xyz). + +## Custody + +The plugin never holds keys or signs. It constructs **unsigned** transactions that your own wallet signs and broadcasts. `submit_hash` accepts an already-broadcast transaction hash for tracking only. + +Yield.xyz is SOC 2 compliant — [trust.yield.xyz](https://trust.yield.xyz). + +## Connectors + +Signing and execution connectors build on this plugin: `yield-xyz-agentkit-privy`, `yield-xyz-agentkit-moonpay`, and `yield-xyz-agentkit-robinhood`. See [`plugins/README.md`](../README.md). + +## Links + +- [Docs](https://docs.yield.xyz/docs/agents-overview) +- [MCP tool reference](https://docs.yield.xyz/docs/tool-reference) + diff --git a/plugins/yield-xyz-agentkit/assets/logo.png b/plugins/yield-xyz-agentkit/assets/logo.png new file mode 100644 index 0000000..6d5df98 Binary files /dev/null and b/plugins/yield-xyz-agentkit/assets/logo.png differ