diff --git a/.grok-plugin/marketplace.json b/.grok-plugin/marketplace.json new file mode 100644 index 0000000..1b5e28a --- /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": "finance", + "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", "defi", "staking", "lending", "apy", "web3", "ethereum", "solana"], + "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": "finance", + "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 api", "defi", "sdk", "developer", "integration", "web3"], + "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": "finance", + "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", "privy", "agentic wallet", "signing", "defi", "yield", "web3"], + "domains": ["privy.io", "docs.privy.io", "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": "finance", + "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", "moonpay", "wallet", "signing", "defi", "yield", "web3"], + "domains": ["moonpay.com", "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": "finance", + "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", "robinhood chain", "robinhood", "evm", "mainnet", "defi", "yield", "web3"], + "domains": ["robinhood.com", "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..4822eaf --- /dev/null +++ b/plugins/yield-xyz-agentkit-builder/.grok-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "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"], + "logo": "assets/logo.png" +} diff --git a/plugins/yield-xyz-agentkit-builder/assets/logo.png b/plugins/yield-xyz-agentkit-builder/assets/logo.png new file mode 100644 index 0000000..6d5df98 Binary files /dev/null and b/plugins/yield-xyz-agentkit-builder/assets/logo.png differ 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..58b262d --- /dev/null +++ b/plugins/yield-xyz-agentkit-moonpay/.grok-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "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"], + "logo": "assets/logo.png" +} diff --git a/plugins/yield-xyz-agentkit-moonpay/assets/logo.png b/plugins/yield-xyz-agentkit-moonpay/assets/logo.png new file mode 100644 index 0000000..6d5df98 Binary files /dev/null and b/plugins/yield-xyz-agentkit-moonpay/assets/logo.png differ 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..350939c --- /dev/null +++ b/plugins/yield-xyz-agentkit-privy/.grok-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "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"], + "logo": "assets/logo.png" +} diff --git a/plugins/yield-xyz-agentkit-privy/assets/logo.png b/plugins/yield-xyz-agentkit-privy/assets/logo.png new file mode 100644 index 0000000..6d5df98 Binary files /dev/null and b/plugins/yield-xyz-agentkit-privy/assets/logo.png differ 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..6bcc671 --- /dev/null +++ b/plugins/yield-xyz-agentkit-robinhood/.grok-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "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"], + "logo": "assets/logo.png" +} diff --git a/plugins/yield-xyz-agentkit-robinhood/assets/logo.png b/plugins/yield-xyz-agentkit-robinhood/assets/logo.png new file mode 100644 index 0000000..6d5df98 Binary files /dev/null and b/plugins/yield-xyz-agentkit-robinhood/assets/logo.png differ 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/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