Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
65 changes: 65 additions & 0 deletions .grok-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -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"]
}
]
}
42 changes: 39 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -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.

---

Expand Down Expand Up @@ -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`

Expand All @@ -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)

---
Expand Down
8 changes: 7 additions & 1 deletion plugins/README.md
Original file line number Diff line number Diff line change
@@ -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/<plugin-name> --trust
```

---

## Plugins
Expand Down
10 changes: 10 additions & 0 deletions plugins/yield-xyz-agentkit-builder/.grok-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"]
}
10 changes: 10 additions & 0 deletions plugins/yield-xyz-agentkit-moonpay/.grok-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"]
}
10 changes: 10 additions & 0 deletions plugins/yield-xyz-agentkit-privy/.grok-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"]
}
10 changes: 10 additions & 0 deletions plugins/yield-xyz-agentkit-robinhood/.grok-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"]
}
11 changes: 11 additions & 0 deletions plugins/yield-xyz-agentkit/.grok-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
}
4 changes: 2 additions & 2 deletions plugins/yield-xyz-agentkit/.mcp.json
Original file line number Diff line number Diff line change
@@ -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"
}
}
}
61 changes: 61 additions & 0 deletions plugins/yield-xyz-agentkit/README.md
Original file line number Diff line number Diff line change
@@ -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": "<your 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)

Binary file added plugins/yield-xyz-agentkit/assets/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.