Agenti
Give AI agents access to money. Manage finances, trade cryptocurrency. MCP server for AI agents to interact with 20+ blockchains. 380+ tools for DeFi, DEX aggregation, security scanning, cross-chain bridges, QR payments. x402 enabled - AI agents can autonomously pay for premium APIs and trade with other agents. Works with Claude, ChatGPT, Cursor.
Install / Use
/learn @nirholas/AgentiQuality Score
Category
Finance & AccountingSupported Platforms
README
What is Agenti?
Agenti is an open-source Model Context Protocol server that connects AI assistants to blockchain networks through natural language. It provides 380+ tools for DeFi, trading, security analysis, and cross-chain operations across 20+ networks.
npx @nirholas/agenti
Works with: Claude Desktop, ChatGPT, Cursor, and any MCP-compatible client.
Why Agenti?
| | Agenti | Other MCP Servers | |---|---|---| | Tools | 380+ | 10-50 | | Chains | 20+ (EVM + Solana, Cosmos, Near, Sui, Aptos) | 1-3 | | DEX Aggregation | 1inch, 0x, ParaSwap | Single or none | | Security | GoPlus, honeypot, rug pull detection | Basic or none | | DeFi | Aave, Compound, Lido, Uniswap | Limited | | Bridges | LayerZero, Stargate, Wormhole | None | | AI Payments | x402 protocol built-in | None | | Transport | stdio, HTTP, SSE | Usually stdio only |
Quick Start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"agenti": {
"command": "npx",
"args": ["-y", "@nirholas/agenti@latest"],
"env": {
"PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Cursor
Add to your MCP settings with the same configuration as above.
ChatGPT
- Enable Developer Mode in settings
- Run:
npx @nirholas/agenti@latest --http - In ChatGPT Settings > Apps > Create app, enter:
http://localhost:3001/mcp
See the full ChatGPT Setup Guide for details.
Server Modes
| Mode | Command | Client |
|------|---------|--------|
| stdio | npx @nirholas/agenti | Claude Desktop, Cursor |
| HTTP | npx @nirholas/agenti --http | ChatGPT |
| SSE | npx @nirholas/agenti --sse | Legacy HTTP clients |
Supported Networks
EVM Chains
Ethereum, Arbitrum, Base, Optimism, Polygon, BNB Chain, Avalanche, Fantom, zkSync Era, Linea, Scroll, Blast, Mode, Mantle, opBNB, and all testnets.
Multi-Chain
Solana, Cosmos/IBC, Near, Sui, Aptos, TON, XRP Ledger, Bitcoin, Litecoin, THORChain.
Features
DeFi Operations
- Swaps — Token swaps via 1inch, 0x, ParaSwap with MEV protection
- Lending — Aave, Compound positions and rates
- Staking — Liquid staking (Lido), LP farming, yield optimization
- Bridges — Cross-chain via LayerZero, Stargate, Wormhole
Market Intelligence
- Prices — CoinGecko, CoinStats, oracle aggregation, TWAP
- Analytics — DefiLlama TVL, yields, fees, protocol metrics
- Technical Analysis — 50+ indicators (RSI, MACD, Bollinger Bands, etc.)
- Social Sentiment — LunarCrush metrics, trending topics
- News — Real-time crypto news aggregation
Security & Analysis
- Token Safety — GoPlus security checks, honeypot detection, rug pull scanning
- Wallet Security — Approval auditing, drainer detection, risk scoring
- Contract Analysis — Proxy detection, source verification, malicious function detection
Infrastructure
- ENS/Domains — Register, resolve, manage domains and subdomains
- Governance — Snapshot votes, on-chain proposals, delegation
- Deployment — CREATE2, upgradeable proxies, contract verification
- Real-time — WebSocket price streams, trade feeds, mempool monitoring
- Portfolio — Cross-chain tracking, whale analytics, wallet scoring
x402 Payment Protocol
AI agents can now make and receive cryptocurrency payments autonomously.
User: "Get premium weather data for Tokyo"
Claude: Checking x402 balance... $45.23 USDs
Paying $0.01 for premium API access...
Payment confirmed! Here's your detailed forecast...
Capabilities
- Pay for APIs — Automatic HTTP 402 payment handling
- Autonomous Payments — No human approval needed
- Earn Yield — Payments use USDs stablecoin (~5% APY)
- Multi-chain — EVM chains + Solana
Setup
export X402_PRIVATE_KEY=0x...
export X402_CHAIN=arbitrum # or base, ethereum, polygon
x402 Tools
| Tool | Description |
|------|-------------|
| x402_pay_request | HTTP request with automatic 402 payment |
| x402_balance | Check wallet balance (USDC/USDs + native) |
| x402_send | Send direct payment |
| x402_batch_send | Send multiple payments in one transaction |
| x402_gasless_send | Send payment without paying gas |
| x402_estimate | Check cost before paying |
| x402_address | Get wallet address |
| x402_networks | List supported networks |
| x402_yield | Check USDs auto-yield earnings |
| x402_apy | Get current APY rate |
| x402_yield_estimate | Project future yield |
| x402_approve | Approve token spending |
| x402_tx_status | Check transaction status |
| x402_config | View current configuration |
Supported Networks
| Network | CAIP-2 | Status |
|---------|--------|--------|
| Base | eip155:8453 | Recommended |
| Arbitrum | eip155:42161 | Supported |
| Ethereum | eip155:1 | Supported |
| Polygon | eip155:137 | Supported |
| Solana | solana:mainnet | Supported |
Full x402 documentation: Overview | Quickstart | Tools Reference | Architecture | Security
Example Prompts
Trading & DeFi
Swap 0.1 ETH for USDC on Arbitrum
What's the best rate to swap 500 DAI to ETH across all DEXs?
Show me Aave lending rates for USDC on Arbitrum
Bridge 100 USDC from Ethereum to Arbitrum
Market Analysis
What's the current price of Bitcoin and Ethereum?
Show me the top 10 trending coins on CoinGecko
Calculate RSI for Bitcoin over the last 14 days
What's the social sentiment for Bitcoin right now?
Security
Is this token safe? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE
Check if this token is a honeypot on BSC
Scan my wallet for risky approvals: 0xYourAddress
Portfolio & Analytics
Show my token balances on Ethereum: 0xYourAddress
What's the total TVL of Aave across all chains?
Track my portfolio across all EVM chains
Get all Transfer events for USDC in the last 100 blocks
For 100+ more prompts, see the Prompts Guide.
Configuration
Environment Variables
# Required for write operations (swaps, transfers, etc.)
PRIVATE_KEY=your_private_key_here
# Market data (optional - free tier available)
COINGECKO_API_KEY=your_key
COINSTATS_API_KEY=your_key
# Social & news (optional)
LUNARCRUSH_API_KEY=your_key
CRYPTOPANIC_API_KEY=your_key
# Cross-chain (optional)
RUBIC_API_KEY=your_key
# Custom RPCs (optional - uses public RPCs by default)
ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
What Works Without API Keys
| Feature | Free | With API Key | |---------|------|-------------| | Token prices (CoinGecko) | Yes | Higher rate limits | | DeFi analytics (DefiLlama) | Yes | - | | Security checks (GoPlus) | Yes | - | | DEX analytics (GeckoTerminal) | Yes | - | | Social sentiment | No | LunarCrush | | Crypto news | No | CryptoPanic |
Development
git clone https://github.com/nirholas/agenti
cd agenti
npm install
npm run dev # stdio mode (Claude)
npm run dev:http # HTTP mode (ChatGPT)
npm run dev:sse # SSE mode (legacy)
Testing
npm test # Unit tests
npm run test:e2e # End-to-end tests
npm run test:coverage # Coverage report
npm run test:watch # Watch mode
npm run test:inspector # MCP Inspector UI
Project Structure
src/
├── index.ts # Entry point
├── cli.ts # CLI handler
├── evm/ # EVM blockchain modules
│ ├── modules/ # Swap, bridge, staking, lending, etc.
│ └── services/ # Shared services
├── modules/ # Non-EVM modules (23 total)
├── server/ # Transport layer (stdio, HTTP, SSE)
├── vendors/ # Third-party API integrations
├── x402/ # Payment protocol
└── utils/ # Shared utilities
packages/ # Monorepo packages
├── chains/ # Chain-specific servers
├── data/ # Data aggregation
├── exchanges/ # Exchange integrations
├── protocols/ # Protocol-specific tools
├── wallets/ # Wallet toolkits
└── ... # 14 package categories total
Data Sources
| Provider | Data Type | API Key | |----------|-----------|---------| | CoinGecko | Prices, OHLCV, trending |
Related Skills
gh-issues
337.1kFetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]
oracle
337.1kBest practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
tmux
337.1kRemote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
xurl
337.1kA CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
