Automation · AI Agents
Give AI agents a safe way onto Robinhood Chain.
@hoodstack/agent-kit lets an AI agent read chain state, inspect tokens, and simulate transactions through HoodStack, over the Model Context Protocol or as a framework-agnostic toolkit. Every tool is a read or a simulation, so an agent can plan and verify before anything is signed.
Two ways to use it
An MCP server and a toolkit.
One small package. Plug it into an assistant over MCP, or wire the tools into your own agent framework.
MCP server
Expose the tools to any Model Context Protocol client, Claude Desktop, Claude Code, and others, with one config block and your key.
{
"mcpServers": {
"hoodstack": {
"command": "npx",
"args": ["-y", "@hoodstack/agent-kit", "hoodstack-mcp"],
"env": { "HOODSTACK_API_KEY": "hs_test_your_key" }
}
}
}Toolkit
Import the tools and run them directly, or adapt them into the Vercel AI SDK, LangChain, or a raw function-calling loop.
import { createHoodStackAgent } from "@hoodstack/agent-kit";
const agent = createHoodStackAgent({ apiKey: process.env.HOODSTACK_API_KEY! });
// Simulate before acting - nothing is signed or submitted.
const sim = await agent.run("hoodstack_simulate_transaction", {
to: "0x…",
valueWei: "10000000000000000",
});What an agent can do
Read and simulate, safely.
Eight tools over the live HoodStack API. Each is authenticated by your key, rate limited, and metered through one gateway.
- hoodstack_health
- Verify the key and report the network and project
- hoodstack_get_account
- Balance, nonce, and contract detection for an address
- hoodstack_get_transaction
- A transaction and its receipt, by hash
- hoodstack_get_block
- A block header (latest by default)
- hoodstack_get_token
- ERC-20 metadata and an optional holder balance
- hoodstack_get_gas
- Current gas price, base fee, and transfer cost
- hoodstack_simulate_transaction
- Simulate a call and estimate gas, no signing
- hoodstack_rpc
- A read-only JSON-RPC call for anything else
Non-custodial by construction
No key. No custody.
The kit only reads and simulates. There is no signing key anywhere in it, and HoodStack cannot move user funds. An agent can inspect and plan without ever being able to spend.
Live today
Reads and transaction simulation across accounts, transactions, blocks, tokens, gas, and raw read-only RPC, over the live API on testnet and mainnet.
On the roadmap
Signed, policy-bounded execution: an agent submits from a smart account it owns, bounded by server-side spend limits and allowlists, relayed by HoodStack. Proven on testnet and being wired into the platform. It stays non-custodial, the agent signs, the relayer only relays.