Back to skills
SkillHub ClubShip Full StackFull StackIntegration
BNB Chain MCP Agent Guide
Imported from https://github.com/nirholas/sperax-crypto-mcp.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Stars
16
Hot score
86
Updated
March 20, 2026
Overall rating
C1.6
Composite score
1.6
Best-practice grade
F19.6
Install command
npx @skill-hub/cli install nirholas-sperax-crypto-mcp-bnb-chain-mcp
Repository
nirholas/sperax-crypto-mcp
Skill path: BNB-Chain-MCP
Imported from https://github.com/nirholas/sperax-crypto-mcp.
Open repositoryBest for
Primary workflow: Ship Full Stack.
Technical facets: Full Stack, Integration.
Target audience: everyone.
License: Apache-2.0.
Original source
Catalog source: SkillHub Club.
Repository owner: nirholas.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install BNB Chain MCP Agent Guide into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/nirholas/sperax-crypto-mcp before adding BNB Chain MCP Agent Guide to shared team environments
- Use BNB Chain MCP Agent Guide for development workflows
Works across
Claude CodeCodex CLIGemini CLIOpenCode
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: BNB Chain MCP Agent Guide
version: 1.0.0
author: nich (@nichxbt)
repository: https://github.com/nirholas/bnbchain-mcp
license: Apache-2.0
---
# 🤖 BNB Chain MCP - AI Agent Integration Guide
Comprehensive documentation for integrating the BNB Chain MCP Server with AI agents, frameworks, and multi-agent systems. Includes BSC EVM, BNB Greenfield storage, and Sperax Protocol tools.
## Table of Contents
1. [Agent Personas](#agent-personas)
2. [Agent Configuration Templates](#agent-configuration-templates)
3. [Agent Capabilities Matrix](#agent-capabilities-matrix)
4. [Multi-Agent Workflows](#multi-agent-workflows)
5. [Safety Guidelines](#safety-guidelines)
6. [Framework Integration](#framework-integration)
7. [Testing Guide](#testing-guide)
---
## 🎭 Agent Personas
Pre-built agent personas optimized for specific crypto/DeFi use cases.
### 1. DeFi Analyst Agent
**Role:** Analyze DeFi protocols, track TVL, yields, and provide data-driven insights.
**Primary Skills:**
- `defi_get_protocols`, `defi_get_protocol`, `defi_get_chain_tvl`
- `defi_get_yields`, `defi_get_fees`
- `market_get_coins`, `market_get_ohlcv`
- `analytics_*` tools
**Conversation Style:** Data-driven, uses comparisons, presents metrics clearly
**Example Prompts:**
- "Compare TVL across top 10 DeFi protocols"
- "What are the best yield opportunities on Arbitrum?"
- "Analyze Aave's fee revenue over the last month"
- "Show me the TVL trend for BSC over 30 days"
**System Prompt:**
```
You are a DeFi Analyst Agent specializing in protocol analysis and yield optimization.
Your capabilities include:
- Fetching and analyzing TVL data across protocols and chains
- Comparing yield opportunities across DeFi platforms
- Tracking protocol fees, revenue, and growth metrics
- Providing data-driven recommendations
Always:
1. Use actual data from tools, never make up numbers
2. Compare metrics across multiple protocols when relevant
3. Consider risk factors alongside yield
4. Present data in clear tables or summaries
5. Cite your data sources (DefiLlama, etc.)
When analyzing yields, always check:
- Minimum TVL thresholds for reliability
- APY sustainability (base vs reward APY)
- IL risk for LP positions
```
---
### 2. Portfolio Manager Agent
**Role:** Track holdings, analyze positions, and optimize portfolio allocation.
**Primary Skills:**
- `get_balance`, `get_wallet_portfolio`, `get_token_balance`
- `get_lending_position`, `get_staking_position`
- `security_check_approvals`, `revoke_approval`
- `market_get_price`, `market_get_coin`
**Conversation Style:** Personalized, action-oriented, risk-aware
**Example Prompts:**
- "Show my complete portfolio on Ethereum"
- "What's my health factor on Aave?"
- "Check my token approvals for security risks"
- "How much am I earning from staking?"
**System Prompt:**
```
You are a Portfolio Manager Agent helping users track and optimize their crypto holdings.
Your capabilities include:
- Checking balances across wallets and chains
- Monitoring lending/borrowing positions and health factors
- Tracking staking rewards and farming positions
- Auditing token approvals for security
- Calculating portfolio performance
Guidelines:
1. Always ask for the user's address if not provided
2. Present holdings with USD values when possible
3. Flag unhealthy positions (low health factors, risky approvals)
4. Suggest optimizations based on current market conditions
5. Prioritize security - check approvals regularly
When showing portfolio:
- Group by asset type (native, tokens, NFTs, positions)
- Show percentage allocation
- Highlight high-risk positions
```
---
### 3. Security Auditor Agent
**Role:** Analyze tokens, contracts, and wallets for security risks.
**Primary Skills:**
- `security_check_token`, `detect_honeypot`, `check_rug_risk`
- `security_check_address`, `security_check_nft`
- `security_check_approvals`, `security_check_dapp`
- `check_proxy_contract`, `get_contract_info`
**Conversation Style:** Cautious, thorough, educational
**Example Prompts:**
- "Is this token safe? 0x123..."
- "Check this contract for honeypot risks"
- "Audit my wallet for security vulnerabilities"
- "Is this dApp URL a phishing site?"
**System Prompt:**
```
You are a Security Auditor Agent specializing in crypto security analysis.
Your capabilities include:
- Token security analysis (honeypot, rug pull, tax detection)
- Contract verification and proxy detection
- Wallet approval auditing
- dApp phishing detection
- NFT collection security checks
CRITICAL GUIDELINES:
1. NEVER tell users a token is "safe" - only report findings
2. Always check multiple security indicators
3. Explain risks in plain language
4. Recommend caution for any flagged issues
5. Suggest users verify on multiple sources
Risk Level Definitions:
- LOW: No major red flags, but always DYOR
- MEDIUM: Some concerns, proceed with caution
- HIGH: Multiple red flags, avoid or research more
- CRITICAL: Clear scam indicators, do not interact
When analyzing tokens, ALWAYS check:
- Is it a honeypot?
- Buy/sell tax rates
- Ownership status
- Liquidity lock status
- Holder distribution
```
---
### 4. Trading Assistant Agent
**Role:** Execute swaps, provide quotes, and assist with trading operations.
**Primary Skills:**
- `get_swap_quote`, `execute_swap`
- `get_pool_reserves`, `calculate_arbitrage`
- `dex_get_network_pools`, `dex_get_token_pools`
- `get_gas_price`, `estimate_gas`
**Conversation Style:** Precise, quick, cost-conscious
**Example Prompts:**
- "Get a quote to swap 1 ETH for USDC"
- "What's the best DEX to swap on Arbitrum?"
- "Execute a swap: 100 USDC to DAI on Polygon"
- "Find arbitrage opportunities for WETH/USDC"
**System Prompt:**
```
You are a Trading Assistant Agent helping users execute crypto trades efficiently.
Your capabilities include:
- Getting swap quotes from DEX aggregators
- Executing token swaps with slippage protection
- Finding best liquidity pools
- Calculating price impact and gas costs
- Identifying arbitrage opportunities
Trading Guidelines:
1. ALWAYS show the full quote before execution
2. Include slippage, gas, and total cost in quotes
3. Warn about high price impact (>1%)
4. Suggest optimal gas settings
5. Never execute without user confirmation
Before any swap:
- Check token security (honeypot detection)
- Verify sufficient balance + gas
- Show expected output vs minimum output
- Display the routing path
IMPORTANT: Require explicit confirmation for any transaction.
```
---
### 5. Market Research Agent
**Role:** Provide market data, trends, and social sentiment analysis.
**Primary Skills:**
- `market_get_coins`, `market_get_trending`
- `market_get_ohlcv`, `market_get_fear_greed`
- `social_get_coin_metrics`, `social_get_trending_posts`
- `news_get_latest`, `news_search`
**Conversation Style:** Informative, balanced, data-backed
**Example Prompts:**
- "What are today's trending cryptocurrencies?"
- "Show me Bitcoin's price history this month"
- "What's the social sentiment for Ethereum?"
- "Any breaking crypto news?"
**System Prompt:**
```
You are a Market Research Agent providing crypto market intelligence.
Your capabilities include:
- Real-time price data and historical charts
- Trending coins and market movers
- Social sentiment analysis (Galaxy Score, AltRank)
- Crypto news aggregation
- Fear & Greed Index tracking
Research Guidelines:
1. Present data objectively without financial advice
2. Include multiple data points for context
3. Note data freshness/timestamps
4. Compare against market benchmarks
5. Distinguish between facts and speculation
When presenting market data:
- Include 24h and 7d changes
- Show volume alongside price
- Note market cap rank
- Include relevant news if available
DISCLAIMER: Always remind users this is not financial advice.
```
---
### 6. Cross-Chain Navigator Agent
**Role:** Assist with bridging, multi-chain operations, and chain comparisons.
**Primary Skills:**
- `get_bridge_quote`, `execute_bridge`, `get_bridge_status`
- `get_supported_networks`, `get_chain_info`
- `defi_get_chains`, `defi_get_chain_tvl`
- Network-specific balance checks
**Conversation Style:** Helpful, patient, detail-oriented
**Example Prompts:**
- "Bridge 100 USDC from Ethereum to Arbitrum"
- "Compare gas fees across chains"
- "Which chain has the most DeFi activity?"
- "Track my bridge transaction status"
**System Prompt:**
```
You are a Cross-Chain Navigator Agent helping users operate across multiple blockchains.
Your capabilities include:
- Getting bridge quotes and executing transfers
- Comparing gas costs across chains
- Tracking bridge transaction status
- Explaining chain differences
- Finding the best routes for cross-chain transfers
Bridging Guidelines:
1. ALWAYS show fees and estimated time before bridging
2. Explain native token requirements on destination
3. Warn about potential delays
4. Provide transaction tracking links
5. Suggest optimal bridging times (gas)
Before any bridge:
- Verify source chain balance
- Check destination chain gas requirements
- Compare multiple bridge options
- Explain any risks (centralized vs decentralized)
Supported chains: Ethereum, BSC, Arbitrum, Polygon, Base, Optimism, opBNB
```
---
### 7. Governance Participant Agent
**Role:** Track proposals, delegate votes, and participate in DAO governance.
**Primary Skills:**
- `governance_get_proposal`, `governance_vote`
- `governance_delegate`, `governance_get_voting_power`
- `governance_create_proposal`, `governance_queue_proposal`
**Conversation Style:** Neutral, informative, procedural
**Example Prompts:**
- "Show active governance proposals for Uniswap"
- "What's my voting power?"
- "Delegate my votes to vitalik.eth"
- "Vote FOR on proposal #42"
**System Prompt:**
```
You are a Governance Participant Agent helping users engage in DAO governance.
Your capabilities include:
- Tracking active proposals and their status
- Checking and displaying voting power
- Delegating votes to other addresses
- Casting votes on proposals
- Explaining proposal impacts
Governance Guidelines:
1. Present proposals neutrally - don't advocate for positions
2. Explain the voting process clearly
3. Show voting deadlines prominently
4. Verify voting power before voting
5. Confirm all governance actions
When presenting proposals:
- Show current vote counts
- Display time remaining
- Explain what the proposal does
- List key supporters/opposers if known
IMPORTANT: Governance actions are irreversible. Always confirm before executing.
```
---
### 8. NFT Explorer Agent
**Role:** Explore NFT collections, check ownership, and analyze NFT data.
**Primary Skills:**
- `get_nft_metadata`, `get_nft_owner`
- `get_nfts_by_owner`, `get_nft_collection_info`
- `security_check_nft`, `transfer_nft`
- `approve_nft`, `set_approval_for_all`
**Conversation Style:** Visual when possible, descriptive, organized
**Example Prompts:**
- "Show my NFTs on Ethereum"
- "Get metadata for BAYC #1234"
- "Is this NFT collection legitimate?"
- "Transfer my NFT to another wallet"
**System Prompt:**
```
You are an NFT Explorer Agent helping users navigate the NFT ecosystem.
Your capabilities include:
- Fetching NFT metadata and traits
- Checking NFT ownership
- Listing NFTs by wallet
- Collection security analysis
- NFT transfers and approvals
NFT Guidelines:
1. Always show the image/media when available
2. List traits and rarity when known
3. Check collection verification status
4. Warn about suspicious collections
5. Verify ownership before transfers
When displaying NFTs:
- Show name, collection, and token ID
- Include trait count and rarity (if available)
- Note the current owner
- Flag any security concerns
Before transfers:
- Verify current ownership
- Confirm recipient address
- Check for existing approvals
```
---
## ⚙️ Agent Configuration Templates
Ready-to-use configurations for major platforms.
### Claude Desktop Configuration
```json
{
"mcpServers": {
"bnbchain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnbchain-mcp@latest"],
"env": {
"PRIVATE_KEY": "your_private_key_optional",
"COINGECKO_API_KEY": "your_key_optional",
"LUNARCRUSH_API_KEY": "your_key_optional"
}
}
}
}
```
### ChatGPT Developer Mode Configuration
1. Start HTTP server:
```bash
npx @nirholas/bnbchain-mcp@latest --http
```
2. In ChatGPT Settings → Apps → Create app
3. Enter URL: `http://localhost:3001/mcp`
### Cursor Configuration
```json
{
"mcpServers": {
"bnbchain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnbchain-mcp@latest"],
"env": {
"PRIVATE_KEY": "${CRYPTO_PRIVATE_KEY}"
}
}
}
}
```
### Full Agent Configuration (Claude Desktop)
```json
{
"mcpServers": {
"bnbchain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnbchain-mcp@latest"],
"env": {
"PRIVATE_KEY": "0x...",
"COINGECKO_API_KEY": "CG-...",
"COINSTATS_API_KEY": "...",
"LUNARCRUSH_API_KEY": "..."
}
}
},
"systemPrompt": "You are a DeFi Analyst Agent specializing in protocol analysis..."
}
```
### Environment Variables Reference
| Variable | Required | Description |
|----------|----------|-------------|
| `PRIVATE_KEY` | For write ops | Wallet private key for transactions |
| `COINGECKO_API_KEY` | Optional | Higher rate limits for market data |
| `COINSTATS_API_KEY` | For portfolio | Portfolio tracking features |
| `LUNARCRUSH_API_KEY` | For social | Social sentiment analysis |
| `CRYPTOCOMPARE_API_KEY` | Optional | Additional social data |
---
## 📊 Agent Capabilities Matrix
| Agent Persona | Read Ops | Write Ops | APIs | Risk Level |
|--------------|----------|-----------|------|------------|
| DeFi Analyst | ✅ All | ❌ None | DefiLlama, CoinGecko | Low |
| Portfolio Manager | ✅ All | ⚠️ Revoke approvals | All | Medium |
| Security Auditor | ✅ All | ❌ None | GoPlus | Low |
| Trading Assistant | ✅ All | ✅ Swaps | DEX APIs | High |
| Market Research | ✅ All | ❌ None | CoinGecko, LunarCrush | Low |
| Cross-Chain Navigator | ✅ All | ✅ Bridge | Bridge APIs | High |
| Governance Participant | ✅ All | ✅ Vote/Delegate | On-chain | Medium |
| NFT Explorer | ✅ All | ⚠️ Transfers | On-chain | Medium |
### Tool Categories by Agent
```
┌─────────────────────┬───────────────────────────────────────────────────────┐
│ Agent │ Primary Tool Categories │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ DeFi Analyst │ defi_*, market_*, analytics_* │
│ Portfolio Manager │ get_balance, get_*_position, security_check_* │
│ Security Auditor │ security_*, detect_*, check_* │
│ Trading Assistant │ get_swap_*, execute_swap, dex_*, gas_* │
│ Market Research │ market_*, social_*, news_* │
│ Cross-Chain Nav │ *_bridge_*, get_chain_*, defi_get_chains │
│ Governance │ governance_* │
│ NFT Explorer │ *_nft_*, get_nfts_* │
└─────────────────────┴───────────────────────────────────────────────────────┘
```
---
## 🔄 Multi-Agent Workflows
### Workflow 1: Portfolio Health Check
**Agents:** Portfolio Manager → Security Auditor → DeFi Analyst
```mermaid
sequenceDiagram
participant User
participant PM as Portfolio Manager
participant SA as Security Auditor
participant DA as DeFi Analyst
User->>PM: Check my portfolio health
PM->>PM: get_wallet_portfolio
PM->>PM: get_lending_position
PM->>SA: Audit token approvals
SA->>SA: security_check_approvals
SA->>SA: Flag risky approvals
SA->>DA: Analyze positions
DA->>DA: Compare yields
DA->>DA: defi_get_yields
DA->>User: Complete health report
```
**Implementation:**
```typescript
// Agent orchestration pseudo-code
async function portfolioHealthCheck(address: string) {
// Phase 1: Portfolio Manager
const portfolio = await agent.call('get_wallet_portfolio', { address });
const positions = await agent.call('get_lending_position', { address });
// Phase 2: Security Auditor
const approvals = await agent.call('security_check_approvals', { address });
const riskyApprovals = approvals.filter(a => a.risk === 'high');
// Phase 3: DeFi Analyst
const yields = await agent.call('defi_get_yields', {
chain: portfolio.primaryChain,
minTvl: 1000000
});
return generateHealthReport(portfolio, positions, riskyApprovals, yields);
}
```
---
### Workflow 2: Smart Token Purchase
**Agents:** Security Auditor → Market Research → Trading Assistant
```mermaid
sequenceDiagram
participant User
participant SA as Security Auditor
participant MR as Market Research
participant TA as Trading Assistant
User->>SA: I want to buy token 0x123
SA->>SA: security_check_token
SA->>SA: detect_honeypot
alt Token is safe
SA->>MR: Analyze market data
MR->>MR: market_get_coin
MR->>MR: social_get_coin_metrics
MR->>TA: Get best swap route
TA->>TA: get_swap_quote
TA->>User: Present quote & analysis
else Token is risky
SA->>User: ⚠️ Security risks detected
end
```
---
### Workflow 3: Yield Optimization
**Agents:** Portfolio Manager → DeFi Analyst → Trading Assistant
```mermaid
sequenceDiagram
participant User
participant PM as Portfolio Manager
participant DA as DeFi Analyst
participant TA as Trading Assistant
User->>PM: Optimize my yield
PM->>PM: Get current positions
PM->>DA: Find better yields
DA->>DA: defi_get_yields
DA->>DA: Compare with current
alt Better yield found
DA->>TA: Calculate swap needed
TA->>TA: get_swap_quote
TA->>User: Recommend reallocation
else Current is optimal
DA->>User: Portfolio already optimized
end
```
---
### Workflow 4: Cross-Chain Arbitrage Scout
**Agents:** DeFi Analyst → Cross-Chain Navigator → Trading Assistant
```mermaid
flowchart TB
A[DeFi Analyst<br/>Find yield differences] --> B{Opportunity<br/>exists?}
B -->|Yes| C[Cross-Chain Navigator<br/>Calculate bridge costs]
C --> D{Profitable after<br/>fees?}
D -->|Yes| E[Trading Assistant<br/>Execute arbitrage]
D -->|No| F[Report: Not profitable]
B -->|No| G[Report: No opportunities]
E --> H[Monitor positions]
```
---
## 🛡️ Safety Guidelines
### Read-Only Operations (Safe)
These tools only read data and cannot affect user funds:
```typescript
const READ_ONLY_TOOLS = [
// Balances
'get_balance', 'get_token_balance', 'get_wallet_portfolio',
// Market Data
'market_get_coins', 'market_get_price', 'market_get_trending',
// DeFi Analytics
'defi_get_protocols', 'defi_get_yields', 'defi_get_chains',
// Security (non-invasive)
'security_check_token', 'detect_honeypot', 'check_rug_risk',
// DEX Quotes (no execution)
'get_swap_quote', 'get_pool_reserves', 'dex_get_network_pools',
// Social/News
'social_get_coin_metrics', 'news_get_latest'
];
```
### Write Operations (Require Confirmation)
These tools can affect user funds and MUST require explicit confirmation:
```typescript
const WRITE_TOOLS = [
// Token Operations
'transfer_token', 'approve_token', 'batch_transfer',
// Trading
'execute_swap',
// Bridging
'execute_bridge',
// Lending
'lending_supply', 'lending_withdraw', 'lending_borrow', 'lending_repay',
// Staking
'stake', 'unstake', 'claim_staking_rewards',
// Governance
'governance_vote', 'governance_delegate',
// NFT
'transfer_nft', 'approve_nft'
];
```
### Address Validation Rules
```typescript
// Always validate addresses before operations
function validateAddress(address: string): boolean {
// Must be valid hex format
if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
return false;
}
// Check for common scam patterns
const BLACKLISTED = ['0x0000000000000000000000000000000000000000'];
if (BLACKLISTED.includes(address.toLowerCase())) {
return false;
}
return true;
}
```
### Rate Limiting Recommendations
| API | Recommended Limit | Burst Allowed |
|-----|------------------|---------------|
| CoinGecko (free) | 50/min | No |
| CoinGecko (pro) | 500/min | Yes |
| DefiLlama | No limit | Yes |
| GoPlus | 100/min | No |
| LunarCrush (free) | 100/day | No |
| DexPaprika | 100/min | No |
### Error Handling Patterns
```typescript
// Standard error handling for agent tools
async function safeToolCall(toolName: string, params: any) {
try {
const result = await mcpServer.callTool(toolName, params);
return { success: true, data: result };
} catch (error) {
if (error.code === 'RATE_LIMIT') {
return { success: false, error: 'Rate limited. Please try again later.' };
}
if (error.code === 'INSUFFICIENT_FUNDS') {
return { success: false, error: 'Insufficient balance for this operation.' };
}
if (error.code === 'USER_REJECTED') {
return { success: false, error: 'Transaction rejected by user.' };
}
return { success: false, error: error.message };
}
}
```
---
## 🔌 Framework Integration
### LangChain Integration
```python
from langchain_community.tools import MCPToolkit
from langchain.agents import AgentExecutor, create_openai_functions_agent
from langchain_openai import ChatOpenAI
# Initialize MCP connection
mcp_toolkit = MCPToolkit(
server_command="npx",
server_args=["-y", "@nirholas/bnbchain-mcp@latest"],
env={
"PRIVATE_KEY": os.getenv("CRYPTO_PRIVATE_KEY"),
"COINGECKO_API_KEY": os.getenv("COINGECKO_API_KEY")
}
)
# Get tools from MCP server
tools = mcp_toolkit.get_tools()
# Create agent with DeFi Analyst persona
llm = ChatOpenAI(model="gpt-4", temperature=0)
system_prompt = """You are a DeFi Analyst Agent specializing in protocol analysis.
Use the available tools to fetch real data. Never make up numbers.
Always compare multiple data points for context."""
agent = create_openai_functions_agent(llm, tools, system_prompt)
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
# Run agent
result = agent_executor.invoke({
"input": "What are the top 5 yield opportunities on Arbitrum with TVL > $1M?"
})
```
### AutoGPT Integration
```yaml
# autogpt_config.yaml
ai_settings:
ai_name: DeFi-Analyst-GPT
ai_role: A DeFi analyst that helps users find yield opportunities and analyze protocols
ai_goals:
- Analyze DeFi protocols for yield opportunities
- Monitor portfolio health and positions
- Provide security analysis for tokens
- Track market trends and sentiment
plugins:
- name: bnbchain-mcp
command: npx
args:
- "-y"
- "@nirholas/bnbchain-mcp@latest"
env:
COINGECKO_API_KEY: "${COINGECKO_API_KEY}"
```
### CrewAI Integration
```python
from crewai import Agent, Task, Crew
from crewai_tools import MCPTool
# Create MCP tools
mcp_defi = MCPTool(
name="DeFi Analytics",
server_command="npx @nirholas/bnbchain-mcp@latest",
tools=["defi_get_protocols", "defi_get_yields", "defi_get_fees"]
)
mcp_security = MCPTool(
name="Security Analysis",
server_command="npx @nirholas/bnbchain-mcp@latest",
tools=["security_check_token", "detect_honeypot", "check_rug_risk"]
)
# Create specialized agents
defi_analyst = Agent(
role="DeFi Analyst",
goal="Analyze DeFi protocols and find yield opportunities",
backstory="Expert in DeFi protocol analysis with deep knowledge of yield farming",
tools=[mcp_defi],
verbose=True
)
security_auditor = Agent(
role="Security Auditor",
goal="Analyze tokens and contracts for security risks",
backstory="Security expert specializing in smart contract and token analysis",
tools=[mcp_security],
verbose=True
)
# Define tasks
analysis_task = Task(
description="Find the top 5 yield opportunities on {chain} with TVL > $1M",
agent=defi_analyst
)
security_task = Task(
description="Verify the security of tokens found in the yield opportunities",
agent=security_auditor,
context=[analysis_task]
)
# Create crew
crew = Crew(
agents=[defi_analyst, security_auditor],
tasks=[analysis_task, security_task],
verbose=2
)
# Run
result = crew.kickoff(inputs={"chain": "Arbitrum"})
```
### Custom Framework Integration
```typescript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
class CryptoAgent {
private client: Client;
async initialize() {
const transport = new StdioClientTransport({
command: "npx",
args: ["-y", "@nirholas/bnbchain-mcp@latest"],
env: {
COINGECKO_API_KEY: process.env.COINGECKO_API_KEY,
}
});
this.client = new Client({
name: "crypto-agent",
version: "1.0.0"
}, {
capabilities: {}
});
await this.client.connect(transport);
}
async getYields(chain: string, minApy: number = 5) {
const result = await this.client.callTool({
name: "defi_get_yields",
arguments: { chain, minApy }
});
return JSON.parse(result.content[0].text);
}
async checkTokenSafety(network: string, tokenAddress: string) {
const [security, honeypot] = await Promise.all([
this.client.callTool({
name: "security_check_token",
arguments: { network, tokenAddress }
}),
this.client.callTool({
name: "detect_honeypot",
arguments: { network, tokenAddress }
})
]);
return {
security: JSON.parse(security.content[0].text),
honeypot: JSON.parse(honeypot.content[0].text)
};
}
}
// Usage
const agent = new CryptoAgent();
await agent.initialize();
const yields = await agent.getYields("Arbitrum", 10);
console.log("Top yields:", yields);
```
---
## 🧪 Testing Guide
### MCP Inspector Usage
Test tools interactively with MCP Inspector:
```bash
# Install MCP Inspector
npm install -g @anthropic-ai/mcp-inspector
# Start BNB Chain MCP server
npx @nirholas/bnbchain-mcp@latest &
# Connect Inspector
mcp-inspector stdio -- npx @nirholas/bnbchain-mcp@latest
```
### Test Cases
#### Basic Connectivity Test
```typescript
// Test: Server responds to tool list request
const tools = await client.listTools();
expect(tools.length).toBeGreaterThan(100);
```
#### Market Data Test
```typescript
// Test: Can fetch Bitcoin price
const result = await client.callTool({
name: "market_get_price",
arguments: { ids: ["bitcoin"], vsCurrencies: ["usd"] }
});
const data = JSON.parse(result.content[0].text);
expect(data.bitcoin.usd).toBeGreaterThan(0);
```
#### DeFi Data Test
```typescript
// Test: Can fetch protocol TVL
const result = await client.callTool({
name: "defi_get_protocol",
arguments: { protocol: "aave" }
});
const data = JSON.parse(result.content[0].text);
expect(data.tvl).toBeGreaterThan(0);
expect(data.chains).toContain("Ethereum");
```
#### Security Check Test
```typescript
// Test: Can detect honeypot (use known honeypot)
const result = await client.callTool({
name: "detect_honeypot",
arguments: {
network: "bsc",
tokenAddress: "0x..." // Known honeypot
}
});
const data = JSON.parse(result.content[0].text);
expect(data.isHoneypot).toBe(true);
```
### Mock Data for Testing
```typescript
// Mock responses for testing without API calls
const MOCK_DATA = {
market_get_price: {
bitcoin: { usd: 50000, usd_24h_change: 2.5 },
ethereum: { usd: 3000, usd_24h_change: -1.2 }
},
defi_get_yields: {
data: [
{ pool: "USDC-USDT", chain: "Ethereum", apy: 5.5, tvlUsd: 10000000 },
{ pool: "ETH-USDC", chain: "Arbitrum", apy: 12.3, tvlUsd: 5000000 }
]
},
security_check_token: {
isHoneypot: false,
buyTax: "0%",
sellTax: "0%",
riskLevel: "low"
}
};
```
### Performance Benchmarks
| Operation | Expected Time | Max Acceptable |
|-----------|--------------|----------------|
| Market price lookup | <500ms | 2s |
| DeFi protocol data | <1s | 3s |
| Security check | <2s | 5s |
| Swap quote | <3s | 10s |
| Bridge quote | <5s | 15s |
---
## 📚 Additional Resources
- **GitHub Repository:** https://github.com/nirholas/bnbchain-mcp
- **Documentation:** https://bnbchain-mcp.vercel.app
- **MCP Specification:** https://modelcontextprotocol.io
- **Skills Reference:** [SKILLS.md](./SKILLS.md)
---
## 📜 License
Apache-2.0 License - Built by **[nich](https://x.com/nichxbt)**
---
## Referenced Files
> The following files are referenced in this skill and included for context.
### SKILLS.md
```markdown
---
name: BNB Chain MCP Server
version: 1.0.0
author: nich (@nichxbt)
repository: https://github.com/nirholas/bnbchain-mcp
license: Apache-2.0
categories: [blockchain, defi, trading, analytics, security, nft, cross-chain, bnb-chain, greenfield, sperax]
networks: [bsc, opbnb, greenfield, arbitrum, ethereum, polygon, base, optimism, avalanche]
tools: 200+
resources: 15+
prompts: 25+
---
# 🎯 BNB Chain MCP Skills Manifest
A comprehensive Model Context Protocol server for the **BNB Chain ecosystem** - BSC EVM, BNB Greenfield storage, and Sperax Protocol (USDs stablecoin).
## 📊 Skill Overview
| Category | Skills | Description |
|----------|--------|-------------|
| [Network & Chain](#network--chain-operations) | 12 | Chain info, status, finality |
| [Blocks](#block-operations) | 8 | Block queries, analysis |
| [Transactions](#transaction-operations) | 10 | Send, track, simulate txs |
| [Wallet](#wallet-operations) | 15 | Balances, signing, HD wallets |
| [Tokens (ERC20)](#token-operations-erc20) | 12 | Transfers, approvals, permits |
| [NFTs (ERC721/1155)](#nft-operations) | 14 | Metadata, transfers, marketplace |
| [DEX/Swap](#dex--swap-operations) | 15 | Quotes, swaps, liquidity |
| [Bridge](#cross-chain-bridge) | 8 | Cross-chain transfers |
| [Lending](#lending--borrowing) | 12 | Supply, borrow, health |
| [Staking](#staking-operations) | 10 | Stake, liquid staking, farms |
| [Security](#security-analysis) | 15 | Honeypot, rug detection |
| [Price Feeds](#price--oracle-feeds) | 10 | Chainlink, aggregated prices |
| [Market Data](#market-data) | 20 | CoinGecko, CoinStats |
| [DeFi Analytics](#defi-analytics) | 18 | DefiLlama TVL, yields |
| [DEX Analytics](#dex-analytics) | 16 | Pools, OHLCV, trades |
| [Social Sentiment](#social-sentiment) | 12 | LunarCrush, trending |
| [Governance](#governance) | 10 | Proposals, voting |
| [Gas](#gas-utilities) | 6 | Prices, EIP-1559 |
| [Signatures](#signatures--encoding) | 8 | EIP-712, verification |
| [ENS/Domains](#ens--domains) | 8 | Resolution, registration |
| [Events](#events--logs) | 6 | Historical, filtering |
| [Deployment](#contract-deployment) | 6 | Deploy, verify, upgrade |
| [MEV Protection](#mev-protection) | 6 | Flashbots, private txs |
| [News](#crypto-news) | 7 | Aggregated news feeds |
---
## 🔗 Network & Chain Operations
### `get_chain_info`
**Complexity:** ⭐ (1/5)
Get comprehensive chain information for any supported network.
**Input Schema:**
```typescript
{
network: string // Network identifier (e.g., "bsc", "ethereum", "arbitrum")
}
```
**Output Schema:**
```typescript
{
network: string,
chainId: number,
blockNumber: string,
rpcUrl: string
}
```
**Example Usage:**
```
Get the current block number and chain ID for BNB Smart Chain
```
**Related Skills:** `get_supported_networks`, `estimate_block_time`
---
### `get_supported_networks`
**Complexity:** ⭐ (1/5)
List all supported blockchain networks.
**Input Schema:** None
**Output Schema:**
```typescript
{
supportedNetworks: string[]
}
```
**Example Usage:**
```
What blockchain networks are supported?
```
---
### `estimate_block_time`
**Complexity:** ⭐⭐ (2/5)
Estimate average block time by analyzing recent blocks.
**Input Schema:**
```typescript
{
network: string,
sampleSize?: number // 5-100, default 20
}
```
**Output Schema:**
```typescript
{
averageBlockTimeSeconds: number,
blocksPerMinute: number,
blocksPerHour: number,
blocksPerDay: number
}
```
---
### `get_finality_status`
**Complexity:** ⭐⭐ (2/5)
Check the finality status of a block (pending, confirmed, finalized).
**Input Schema:**
```typescript
{
network: string,
blockNumber?: string
}
```
**Output Schema:**
```typescript
{
finalityStatus: "pending" | "included" | "confirmed" | "highly_confirmed" | "safe" | "finalized",
confirmations: number
}
```
---
### `get_gas_oracle`
**Complexity:** ⭐⭐ (2/5)
Get gas price oracle data including EIP-1559 suggestions.
**Input Schema:**
```typescript
{
network: string
}
```
**Related Skills:** `estimate_gas`, `get_gas_price`
---
## 📦 Block Operations
### `get_block`
**Complexity:** ⭐ (1/5)
Get block data by number or hash.
**Input Schema:**
```typescript
{
network: string,
blockNumber?: string,
blockHash?: string
}
```
**Output Schema:**
```typescript
{
number: string,
hash: string,
timestamp: number,
transactions: string[],
gasUsed: string,
gasLimit: string
}
```
---
### `get_block_transactions`
**Complexity:** ⭐⭐ (2/5)
Get all transactions in a specific block.
**Input Schema:**
```typescript
{
network: string,
blockNumber: string
}
```
---
### `get_block_range`
**Complexity:** ⭐⭐ (2/5)
Get blocks within a specified range.
**Input Schema:**
```typescript
{
network: string,
fromBlock: string,
toBlock: string
}
```
---
## 💸 Transaction Operations
### `send_transaction`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Send a transaction on any supported network.
**Input Schema:**
```typescript
{
network: string,
to: string,
value?: string,
data?: string,
gasLimit?: string,
privateKey: string
}
```
**Output Schema:**
```typescript
{
hash: string,
from: string,
to: string,
value: string
}
```
**Example Usage:**
```
Send 0.1 BNB to 0x742d35Cc6634C0532925a3b844Bc9e7595f... on BSC
```
**Related Skills:** `estimate_gas`, `get_transaction_receipt`
---
### `get_transaction`
**Complexity:** ⭐ (1/5)
Get transaction details by hash.
**Input Schema:**
```typescript
{
network: string,
hash: string
}
```
---
### `get_transaction_receipt`
**Complexity:** ⭐ (1/5)
Get the receipt of a mined transaction.
**Input Schema:**
```typescript
{
network: string,
hash: string
}
```
---
### `simulate_transaction`
**Complexity:** ⭐⭐⭐ (3/5)
Simulate a transaction without broadcasting.
**Input Schema:**
```typescript
{
network: string,
from: string,
to: string,
value?: string,
data?: string
}
```
---
### `decode_transaction`
**Complexity:** ⭐⭐ (2/5)
Decode transaction input data using ABI.
**Input Schema:**
```typescript
{
network: string,
hash: string,
abi?: object[]
}
```
---
### `speed_up_transaction`
**Complexity:** ⭐⭐⭐ (3/5)
Replace a pending transaction with higher gas.
**Input Schema:**
```typescript
{
network: string,
hash: string,
gasPriceMultiplier?: number,
privateKey: string
}
```
---
### `cancel_transaction`
**Complexity:** ⭐⭐⭐ (3/5)
Cancel a pending transaction.
**Input Schema:**
```typescript
{
network: string,
nonce: number,
privateKey: string
}
```
---
## 👛 Wallet Operations
### `get_balance`
**Complexity:** ⭐ (1/5)
Get native token balance for an address.
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
**Output Schema:**
```typescript
{
address: string,
balance: string,
balanceFormatted: string,
symbol: string
}
```
**Example Usage:**
```
What is the BNB balance of 0x742d35Cc6634C0532925a3b844Bc...?
```
---
### `create_wallet`
**Complexity:** ⭐ (1/5)
Generate a new wallet (address + private key).
**Input Schema:** None
**Output Schema:**
```typescript
{
address: string,
privateKey: string
}
```
---
### `generate_mnemonic`
**Complexity:** ⭐ (1/5)
Generate a BIP-39 mnemonic phrase.
**Input Schema:**
```typescript
{
strength?: 12 | 24 // Word count
}
```
---
### `derive_addresses`
**Complexity:** ⭐⭐ (2/5)
Derive multiple addresses from a mnemonic (HD wallet).
**Input Schema:**
```typescript
{
mnemonic: string,
count?: number,
path?: string
}
```
---
### `sign_message`
**Complexity:** ⭐⭐ (2/5)
Sign a message with a private key.
**Input Schema:**
```typescript
{
message: string,
privateKey: string
}
```
**Related Skills:** `verify_signature`
---
### `verify_signature`
**Complexity:** ⭐⭐ (2/5)
Verify a signed message and recover the signer.
**Input Schema:**
```typescript
{
message: string,
signature: string
}
```
---
### `get_token_approvals`
**Complexity:** ⭐⭐ (2/5)
Get all token approvals for an address (security audit).
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
**Related Skills:** `revoke_approval`, `security_check_approvals`
---
### `revoke_approval`
**Complexity:** ⭐⭐⭐ (3/5)
Revoke a token spending approval.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
spenderAddress: string,
privateKey: string
}
```
---
### `get_wallet_portfolio`
**Complexity:** ⭐⭐ (2/5)
Get complete portfolio across all tokens.
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
---
## 🪙 Token Operations (ERC20)
### `get_token_info`
**Complexity:** ⭐ (1/5)
Get token metadata (name, symbol, decimals, supply).
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
**Output Schema:**
```typescript
{
name: string,
symbol: string,
decimals: number,
totalSupply: string
}
```
---
### `get_token_balance`
**Complexity:** ⭐ (1/5)
Get ERC20 token balance for an address.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
walletAddress: string
}
```
---
### `transfer_token`
**Complexity:** ⭐⭐⭐ (3/5)
Transfer ERC20 tokens.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
to: string,
amount: string,
privateKey: string
}
```
---
### `approve_token`
**Complexity:** ⭐⭐⭐ (3/5)
Approve token spending for a spender.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
spender: string,
amount: string,
privateKey: string
}
```
---
### `get_allowance`
**Complexity:** ⭐ (1/5)
Check token allowance for a spender.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
owner: string,
spender: string
}
```
---
### `permit_token`
**Complexity:** ⭐⭐⭐ (3/5)
Gasless approval using EIP-2612 permit.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
spender: string,
amount: string,
deadline: number,
privateKey: string
}
```
---
### `batch_transfer`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Transfer tokens to multiple addresses in one transaction.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
recipients: { address: string, amount: string }[],
privateKey: string
}
```
---
### `wrap_native`
**Complexity:** ⭐⭐ (2/5)
Wrap native tokens (ETH → WETH, BNB → WBNB).
**Input Schema:**
```typescript
{
network: string,
amount: string,
privateKey: string
}
```
---
### `unwrap_native`
**Complexity:** ⭐⭐ (2/5)
Unwrap wrapped native tokens.
**Input Schema:**
```typescript
{
network: string,
amount: string,
privateKey: string
}
```
---
## 🖼️ NFT Operations
### `get_nft_metadata`
**Complexity:** ⭐ (1/5)
Get NFT metadata including traits and image.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string,
tokenId: string
}
```
**Output Schema:**
```typescript
{
name: string,
description: string,
image: string,
attributes: { trait_type: string, value: string }[]
}
```
---
### `get_nft_owner`
**Complexity:** ⭐ (1/5)
Get the current owner of an NFT.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string,
tokenId: string
}
```
---
### `get_nfts_by_owner`
**Complexity:** ⭐⭐ (2/5)
Get all NFTs owned by an address.
**Input Schema:**
```typescript
{
network: string,
ownerAddress: string,
contractAddress?: string
}
```
---
### `transfer_nft`
**Complexity:** ⭐⭐⭐ (3/5)
Transfer an NFT to another address.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string,
tokenId: string,
to: string,
privateKey: string
}
```
---
### `approve_nft`
**Complexity:** ⭐⭐⭐ (3/5)
Approve an address to transfer a specific NFT.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string,
tokenId: string,
spender: string,
privateKey: string
}
```
---
### `set_approval_for_all`
**Complexity:** ⭐⭐⭐ (3/5)
Approve an operator for all NFTs in a collection.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string,
operator: string,
approved: boolean,
privateKey: string
}
```
---
### `get_nft_collection_info`
**Complexity:** ⭐⭐ (2/5)
Get collection metadata (name, supply, etc.).
**Input Schema:**
```typescript
{
network: string,
contractAddress: string
}
```
---
### `batch_transfer_nfts`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Transfer multiple NFTs in one transaction.
**Input Schema:**
```typescript
{
network: string,
transfers: { contractAddress: string, tokenId: string, to: string }[],
privateKey: string
}
```
---
## 🔄 DEX & Swap Operations
### `get_swap_quote`
**Complexity:** ⭐⭐ (2/5)
Get a swap quote from DEX aggregators (1inch, 0x, ParaSwap).
**Input Schema:**
```typescript
{
network: string,
tokenIn: string,
tokenOut: string,
amountIn: string,
slippage?: number
}
```
**Output Schema:**
```typescript
{
amountOut: string,
priceImpact: string,
route: string[],
gasEstimate: string
}
```
**Example Usage:**
```
Get a quote to swap 1 BNB for USDT on BSC
```
**Related Skills:** `execute_swap`, `get_price_impact`
---
### `execute_swap`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Execute a token swap through a DEX.
**Input Schema:**
```typescript
{
network: string,
tokenIn: string,
tokenOut: string,
amountIn: string,
minAmountOut: string,
privateKey: string
}
```
---
### `get_pool_reserves`
**Complexity:** ⭐⭐ (2/5)
Get liquidity pool reserves.
**Input Schema:**
```typescript
{
network: string,
poolAddress: string
}
```
---
### `add_liquidity`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Add liquidity to a DEX pool.
**Input Schema:**
```typescript
{
network: string,
tokenA: string,
tokenB: string,
amountA: string,
amountB: string,
slippage?: number,
privateKey: string
}
```
---
### `remove_liquidity`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Remove liquidity from a DEX pool.
**Input Schema:**
```typescript
{
network: string,
poolAddress: string,
lpAmount: string,
minAmountA?: string,
minAmountB?: string,
privateKey: string
}
```
---
### `calculate_arbitrage`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Find arbitrage opportunities across DEXes.
**Input Schema:**
```typescript
{
network: string,
tokenA: string,
tokenB: string,
amountIn: string
}
```
---
## 🌉 Cross-Chain Bridge
### `get_bridge_quote`
**Complexity:** ⭐⭐⭐ (3/5)
Get a quote for cross-chain token transfer.
**Input Schema:**
```typescript
{
fromNetwork: string,
toNetwork: string,
token: string,
amount: string
}
```
**Output Schema:**
```typescript
{
estimatedOutput: string,
bridgeFee: string,
estimatedTime: string,
bridge: string
}
```
**Example Usage:**
```
How much will I receive bridging 100 USDC from Ethereum to Arbitrum?
```
---
### `execute_bridge`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Execute a cross-chain bridge transfer.
**Input Schema:**
```typescript
{
fromNetwork: string,
toNetwork: string,
token: string,
amount: string,
recipient?: string,
privateKey: string
}
```
---
### `get_bridge_status`
**Complexity:** ⭐⭐ (2/5)
Track the status of a bridge transaction.
**Input Schema:**
```typescript
{
bridgeId: string,
txHash: string
}
```
---
### `get_supported_bridges`
**Complexity:** ⭐ (1/5)
List supported bridges and their routes.
**Input Schema:**
```typescript
{
fromNetwork?: string,
toNetwork?: string
}
```
---
## 🏦 Lending & Borrowing
### `lending_supply`
**Complexity:** ⭐⭐⭐ (3/5)
Supply assets to a lending protocol (Aave, Compound).
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
asset: string,
amount: string,
privateKey: string
}
```
---
### `lending_withdraw`
**Complexity:** ⭐⭐⭐ (3/5)
Withdraw supplied assets from lending protocol.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
asset: string,
amount: string,
privateKey: string
}
```
---
### `lending_borrow`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Borrow assets from a lending protocol.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
asset: string,
amount: string,
privateKey: string
}
```
---
### `lending_repay`
**Complexity:** ⭐⭐⭐ (3/5)
Repay borrowed assets.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
asset: string,
amount: string,
privateKey: string
}
```
---
### `get_lending_position`
**Complexity:** ⭐⭐ (2/5)
Get user's lending/borrowing position.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
address: string
}
```
**Output Schema:**
```typescript
{
supplied: { asset: string, amount: string, apy: string }[],
borrowed: { asset: string, amount: string, apy: string }[],
healthFactor: string,
liquidationThreshold: string
}
```
---
### `get_lending_rates`
**Complexity:** ⭐⭐ (2/5)
Get current supply/borrow APYs for assets.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound",
asset?: string
}
```
---
### `get_liquidatable_positions`
**Complexity:** ⭐⭐⭐ (3/5)
Find positions eligible for liquidation.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "compound"
}
```
---
### `flash_loan`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Execute a flash loan.
**Input Schema:**
```typescript
{
network: string,
protocol: "aave" | "balancer",
assets: string[],
amounts: string[],
callbackData: string,
privateKey: string
}
```
---
## 🥩 Staking Operations
### `stake`
**Complexity:** ⭐⭐⭐ (3/5)
Stake tokens in a staking contract.
**Input Schema:**
```typescript
{
network: string,
stakingContract: string,
amount: string,
privateKey: string
}
```
---
### `unstake`
**Complexity:** ⭐⭐⭐ (3/5)
Unstake/withdraw staked tokens.
**Input Schema:**
```typescript
{
network: string,
stakingContract: string,
amount: string,
privateKey: string
}
```
---
### `claim_staking_rewards`
**Complexity:** ⭐⭐ (2/5)
Claim pending staking rewards.
**Input Schema:**
```typescript
{
network: string,
stakingContract: string,
privateKey: string
}
```
---
### `get_staking_position`
**Complexity:** ⭐⭐ (2/5)
Get user's staking position and pending rewards.
**Input Schema:**
```typescript
{
network: string,
stakingContract: string,
address: string
}
```
---
### `liquid_stake`
**Complexity:** ⭐⭐⭐ (3/5)
Stake for liquid staking tokens (stETH, rETH).
**Input Schema:**
```typescript
{
network: string,
protocol: "lido" | "rocketpool",
amount: string,
privateKey: string
}
```
---
### `get_liquid_staking_rate`
**Complexity:** ⭐ (1/5)
Get exchange rate for liquid staking tokens.
**Input Schema:**
```typescript
{
network: string,
protocol: "lido" | "rocketpool"
}
```
---
### `farm_stake_lp`
**Complexity:** ⭐⭐⭐ (3/5)
Stake LP tokens in a yield farm.
**Input Schema:**
```typescript
{
network: string,
farmContract: string,
lpToken: string,
amount: string,
privateKey: string
}
```
---
### `get_farm_apy`
**Complexity:** ⭐⭐ (2/5)
Get APY for a yield farming pool.
**Input Schema:**
```typescript
{
network: string,
farmContract: string,
poolId: number
}
```
---
## 🔒 Security Analysis
### `security_check_token`
**Complexity:** ⭐⭐ (2/5)
Comprehensive token security analysis using GoPlus.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
**Output Schema:**
```typescript
{
isHoneypot: boolean,
isMintable: boolean,
isPausable: boolean,
hasHiddenOwner: boolean,
buyTax: string,
sellTax: string,
holderCount: number,
liquidityLocked: boolean,
riskLevel: "low" | "medium" | "high" | "critical"
}
```
**Example Usage:**
```
Is this token safe? Check 0x123... on BSC for rug pull risks
```
**Related Skills:** `detect_honeypot`, `check_rug_risk`
---
### `detect_honeypot`
**Complexity:** ⭐⭐ (2/5)
Specifically detect honeypot tokens.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
---
### `check_rug_risk`
**Complexity:** ⭐⭐⭐ (3/5)
Analyze rug pull risk factors.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
---
### `security_check_address`
**Complexity:** ⭐⭐ (2/5)
Check if an address is flagged (scam, phishing, etc.).
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
---
### `security_check_nft`
**Complexity:** ⭐⭐ (2/5)
NFT collection security analysis.
**Input Schema:**
```typescript
{
network: string,
contractAddress: string
}
```
---
### `security_check_approvals`
**Complexity:** ⭐⭐ (2/5)
Audit token approvals for security risks.
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
---
### `security_check_dapp`
**Complexity:** ⭐⭐⭐ (3/5)
Check if a dApp URL is a known phishing site.
**Input Schema:**
```typescript
{
url: string
}
```
---
### `decode_signature`
**Complexity:** ⭐⭐⭐ (3/5)
Decode and analyze a signature request.
**Input Schema:**
```typescript
{
signature: string
}
```
---
### `get_contract_info`
**Complexity:** ⭐⭐ (2/5)
Get contract verification and metadata.
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
---
### `check_proxy_contract`
**Complexity:** ⭐⭐ (2/5)
Detect if contract is a proxy and get implementation.
**Input Schema:**
```typescript
{
network: string,
address: string
}
```
---
## 💰 Price & Oracle Feeds
### `get_chainlink_price`
**Complexity:** ⭐ (1/5)
Get price from Chainlink oracle.
**Input Schema:**
```typescript
{
network: string,
priceFeed: string // e.g., "ETH/USD"
}
```
**Output Schema:**
```typescript
{
price: string,
decimals: number,
updatedAt: number,
roundId: string
}
```
---
### `get_twap_price`
**Complexity:** ⭐⭐⭐ (3/5)
Get time-weighted average price from DEX.
**Input Schema:**
```typescript
{
network: string,
tokenA: string,
tokenB: string,
period: number // seconds
}
```
---
### `get_aggregated_price`
**Complexity:** ⭐⭐ (2/5)
Get price aggregated from multiple sources.
**Input Schema:**
```typescript
{
network: string,
token: string
}
```
---
## 📊 Market Data
### `market_get_coins`
**Complexity:** ⭐ (1/5)
Get cryptocurrency prices and market data.
**Input Schema:**
```typescript
{
name?: string,
symbol?: string,
page?: number,
limit?: number,
categories?: string,
sortBy?: string
}
```
**Output Schema:**
```typescript
{
coins: {
name: string,
symbol: string,
price: number,
marketCap: number,
volume24h: number,
change24h: number,
change7d: number
}[]
}
```
**Example Usage:**
```
Get the top 10 cryptocurrencies by market cap
```
---
### `market_get_coin`
**Complexity:** ⭐ (1/5)
Get detailed data for a specific coin.
**Input Schema:**
```typescript
{
coinId: string // CoinGecko ID
}
```
---
### `market_get_price`
**Complexity:** ⭐ (1/5)
Get current price for specific coins.
**Input Schema:**
```typescript
{
ids: string[], // CoinGecko IDs
vsCurrencies: string[] // e.g., ["usd", "btc"]
}
```
---
### `market_get_historical`
**Complexity:** ⭐⭐ (2/5)
Get historical price data.
**Input Schema:**
```typescript
{
coinId: string,
days: number,
interval?: "minutely" | "hourly" | "daily"
}
```
---
### `market_get_ohlcv`
**Complexity:** ⭐⭐ (2/5)
Get OHLCV candlestick data.
**Input Schema:**
```typescript
{
coinId: string,
vsCurrency: string,
days: number
}
```
---
### `market_get_trending`
**Complexity:** ⭐ (1/5)
Get trending coins.
**Input Schema:** None
---
### `market_get_fear_greed`
**Complexity:** ⭐ (1/5)
Get Fear & Greed Index.
**Input Schema:**
```typescript
{
limit?: number
}
```
---
### `market_get_categories`
**Complexity:** ⭐ (1/5)
Get market data by category.
**Input Schema:**
```typescript
{
order?: string
}
```
---
### `market_get_exchanges`
**Complexity:** ⭐ (1/5)
Get exchange data.
**Input Schema:**
```typescript
{
page?: number,
perPage?: number
}
```
---
### `market_get_derivatives`
**Complexity:** ⭐ (1/5)
Get derivatives market data.
**Input Schema:** None
---
## 📈 DeFi Analytics
### `defi_get_protocols`
**Complexity:** ⭐ (1/5)
Get all DeFi protocols with TVL data.
**Input Schema:** None
**Output Schema:**
```typescript
{
protocols: {
name: string,
tvl: number,
chains: string[],
category: string,
change_1d: number,
change_7d: number
}[]
}
```
**Example Usage:**
```
What are the top DeFi protocols by TVL?
```
---
### `defi_get_protocol`
**Complexity:** ⭐⭐ (2/5)
Get detailed protocol data including chain breakdown.
**Input Schema:**
```typescript
{
protocol: string // slug, e.g., "aave", "uniswap"
}
```
---
### `defi_get_chains`
**Complexity:** ⭐ (1/5)
Get TVL for all chains.
**Input Schema:** None
---
### `defi_get_chain_tvl`
**Complexity:** ⭐⭐ (2/5)
Get historical TVL for a specific chain.
**Input Schema:**
```typescript
{
chain: string // e.g., "Ethereum", "BSC"
}
```
---
### `defi_get_yields`
**Complexity:** ⭐⭐ (2/5)
Get yield/APY data for DeFi pools.
**Input Schema:**
```typescript
{
chain?: string,
project?: string,
minTvl?: number,
minApy?: number
}
```
---
### `defi_get_fees`
**Complexity:** ⭐⭐ (2/5)
Get protocol fees and revenue.
**Input Schema:**
```typescript
{
protocol: string
}
```
---
### `defi_get_stablecoins`
**Complexity:** ⭐ (1/5)
Get stablecoin data and market caps.
**Input Schema:** None
---
### `defi_get_bridges`
**Complexity:** ⭐ (1/5)
Get bridge volume data.
**Input Schema:** None
---
### `defi_get_liquidations`
**Complexity:** ⭐⭐ (2/5)
Get recent liquidation data.
**Input Schema:**
```typescript
{
protocol?: string
}
```
---
### `defi_get_hacks`
**Complexity:** ⭐ (1/5)
Get historical DeFi hacks/exploits.
**Input Schema:** None
---
## 📉 DEX Analytics
### `dex_get_networks`
**Complexity:** ⭐ (1/5)
Get all supported DEX networks. **Call this first!**
**Input Schema:** None
---
### `dex_get_network_pools`
**Complexity:** ⭐⭐ (2/5)
Get top liquidity pools on a network.
**Input Schema:**
```typescript
{
network: string,
orderBy?: "volume_usd" | "price_usd" | "transactions",
limit?: number
}
```
**Example Usage:**
```
Show me the top pools by volume on Ethereum
```
---
### `dex_get_pool_details`
**Complexity:** ⭐⭐ (2/5)
Get detailed pool information.
**Input Schema:**
```typescript
{
network: string,
poolAddress: string
}
```
---
### `dex_get_pool_ohlcv`
**Complexity:** ⭐⭐ (2/5)
Get historical OHLCV data for a pool.
**Input Schema:**
```typescript
{
network: string,
poolAddress: string,
start: string,
end?: string,
interval?: string
}
```
---
### `dex_get_pool_trades`
**Complexity:** ⭐⭐ (2/5)
Get recent trades for a pool.
**Input Schema:**
```typescript
{
network: string,
poolAddress: string,
limit?: number
}
```
---
### `dex_get_token_pools`
**Complexity:** ⭐⭐ (2/5)
Find pools containing a specific token.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
---
### `dex_get_token_details`
**Complexity:** ⭐⭐ (2/5)
Get token trading data from DEXes.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string
}
```
---
### `dex_search_pools`
**Complexity:** ⭐⭐ (2/5)
Search pools across networks.
**Input Schema:**
```typescript
{
query: string // token symbol or address
}
```
---
### `dex_get_trending_pools`
**Complexity:** ⭐ (1/5)
Get trending/hot pools.
**Input Schema:**
```typescript
{
network?: string
}
```
---
### `dex_get_new_pools`
**Complexity:** ⭐ (1/5)
Get recently created pools.
**Input Schema:**
```typescript
{
network: string
}
```
---
## 💬 Social Sentiment
### `social_get_coin_metrics`
**Complexity:** ⭐⭐ (2/5)
Get social metrics for a cryptocurrency.
**Input Schema:**
```typescript
{
symbol: string // e.g., "BTC", "ETH"
}
```
**Output Schema:**
```typescript
{
galaxyScore: number,
altRank: number,
socialVolume: number,
sentiment: number,
twitterFollowers: number
}
```
**Example Usage:**
```
What's the social sentiment for Bitcoin?
```
---
### `social_get_coins_list`
**Complexity:** ⭐ (1/5)
Get social metrics for top coins.
**Input Schema:**
```typescript
{
sort?: "galaxy_score" | "alt_rank" | "social_volume",
limit?: number
}
```
---
### `social_get_feed`
**Complexity:** ⭐ (1/5)
Get social feed (Twitter, Reddit posts).
**Input Schema:**
```typescript
{
symbol?: string,
source?: "twitter" | "reddit" | "news" | "all",
limit?: number
}
```
---
### `social_get_trending_posts`
**Complexity:** ⭐ (1/5)
Get viral/trending crypto posts.
**Input Schema:**
```typescript
{
type?: "rising" | "hot" | "top",
limit?: number
}
```
---
### `social_get_influencers`
**Complexity:** ⭐⭐ (2/5)
Get top crypto influencers.
**Input Schema:**
```typescript
{
symbol?: string,
sort?: "followers" | "engagement" | "influence_score",
limit?: number
}
```
---
### `social_get_trending_topics`
**Complexity:** ⭐ (1/5)
Get trending crypto topics/hashtags.
**Input Schema:** None
---
## 🗳️ Governance
### `governance_create_proposal`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Create an on-chain governance proposal.
**Input Schema:**
```typescript
{
network: string,
governorAddress: string,
targets: string[],
values: string[],
calldatas: string[],
description: string,
privateKey: string
}
```
---
### `governance_vote`
**Complexity:** ⭐⭐⭐ (3/5)
Vote on a governance proposal.
**Input Schema:**
```typescript
{
network: string,
governorAddress: string,
proposalId: string,
support: 0 | 1 | 2, // Against, For, Abstain
privateKey: string
}
```
---
### `governance_delegate`
**Complexity:** ⭐⭐⭐ (3/5)
Delegate voting power.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
delegatee: string,
privateKey: string
}
```
---
### `governance_get_proposal`
**Complexity:** ⭐⭐ (2/5)
Get proposal details and current votes.
**Input Schema:**
```typescript
{
network: string,
governorAddress: string,
proposalId: string
}
```
---
### `governance_get_voting_power`
**Complexity:** ⭐ (1/5)
Get voting power for an address.
**Input Schema:**
```typescript
{
network: string,
tokenAddress: string,
address: string
}
```
---
### `governance_queue_proposal`
**Complexity:** ⭐⭐⭐ (3/5)
Queue a passed proposal for execution.
**Input Schema:**
```typescript
{
network: string,
governorAddress: string,
proposalId: string,
privateKey: string
}
```
---
### `governance_execute_proposal`
**Complexity:** ⭐⭐⭐ (3/5)
Execute a queued proposal.
**Input Schema:**
```typescript
{
network: string,
governorAddress: string,
proposalId: string,
privateKey: string
}
```
---
## ⛽ Gas Utilities
### `get_gas_price`
**Complexity:** ⭐ (1/5)
Get current gas prices.
**Input Schema:**
```typescript
{
network: string
}
```
---
### `get_eip1559_fees`
**Complexity:** ⭐⭐ (2/5)
Get EIP-1559 fee suggestions.
**Input Schema:**
```typescript
{
network: string
}
```
**Output Schema:**
```typescript
{
baseFee: string,
maxPriorityFee: {
slow: string,
average: string,
fast: string
},
maxFee: {
slow: string,
average: string,
fast: string
}
}
```
---
### `estimate_gas`
**Complexity:** ⭐⭐ (2/5)
Estimate gas for a transaction.
**Input Schema:**
```typescript
{
network: string,
from: string,
to: string,
value?: string,
data?: string
}
```
---
### `get_gas_history`
**Complexity:** ⭐⭐ (2/5)
Get historical gas prices.
**Input Schema:**
```typescript
{
network: string,
blockCount: number
}
```
---
## ✍️ Signatures & Encoding
### `sign_typed_data`
**Complexity:** ⭐⭐⭐ (3/5)
Sign EIP-712 typed data.
**Input Schema:**
```typescript
{
domain: object,
types: object,
message: object,
privateKey: string
}
```
---
### `abi_encode`
**Complexity:** ⭐⭐ (2/5)
ABI encode function call data.
**Input Schema:**
```typescript
{
functionSignature: string,
args: any[]
}
```
---
### `abi_decode`
**Complexity:** ⭐⭐ (2/5)
Decode ABI-encoded data.
**Input Schema:**
```typescript
{
types: string[],
data: string
}
```
---
### `keccak256`
**Complexity:** ⭐ (1/5)
Compute keccak256 hash.
**Input Schema:**
```typescript
{
data: string
}
```
---
## 🆔 ENS & Domains
### `ens_resolve`
**Complexity:** ⭐ (1/5)
Resolve ENS name to address.
**Input Schema:**
```typescript
{
name: string // e.g., "vitalik.eth"
}
```
---
### `ens_reverse_resolve`
**Complexity:** ⭐ (1/5)
Resolve address to ENS name.
**Input Schema:**
```typescript
{
address: string
}
```
---
### `ens_register`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Register an ENS domain.
**Input Schema:**
```typescript
{
name: string,
duration: number, // years
privateKey: string
}
```
---
### `ens_set_records`
**Complexity:** ⭐⭐⭐ (3/5)
Set ENS records (text, address, content).
**Input Schema:**
```typescript
{
name: string,
records: { key: string, value: string }[],
privateKey: string
}
```
---
### `ens_transfer`
**Complexity:** ⭐⭐⭐ (3/5)
Transfer ENS domain ownership.
**Input Schema:**
```typescript
{
name: string,
to: string,
privateKey: string
}
```
---
### `ens_renew`
**Complexity:** ⭐⭐⭐ (3/5)
Renew ENS domain registration.
**Input Schema:**
```typescript
{
name: string,
duration: number, // years
privateKey: string
}
```
---
## 📢 Events & Logs
### `get_events`
**Complexity:** ⭐⭐ (2/5)
Get historical contract events.
**Input Schema:**
```typescript
{
network: string,
address: string,
eventSignature?: string,
fromBlock: number,
toBlock: number
}
```
---
### `decode_logs`
**Complexity:** ⭐⭐ (2/5)
Decode event logs using ABI.
**Input Schema:**
```typescript
{
logs: object[],
abi: object[]
}
```
---
### `filter_events`
**Complexity:** ⭐⭐ (2/5)
Filter events by topic.
**Input Schema:**
```typescript
{
network: string,
topics: string[],
fromBlock: number,
toBlock: number
}
```
---
## 🚀 Contract Deployment
### `deploy_contract`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Deploy a smart contract.
**Input Schema:**
```typescript
{
network: string,
bytecode: string,
abi: object[],
constructorArgs?: any[],
privateKey: string
}
```
---
### `deploy_create2`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Deploy with CREATE2 for deterministic addresses.
**Input Schema:**
```typescript
{
network: string,
bytecode: string,
salt: string,
privateKey: string
}
```
---
### `deploy_proxy`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Deploy an upgradeable proxy contract.
**Input Schema:**
```typescript
{
network: string,
implementationAddress: string,
initData: string,
privateKey: string
}
```
---
### `upgrade_proxy`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Upgrade a proxy to new implementation.
**Input Schema:**
```typescript
{
network: string,
proxyAddress: string,
newImplementation: string,
privateKey: string
}
```
---
### `verify_contract`
**Complexity:** ⭐⭐⭐ (3/5)
Verify contract source on block explorer.
**Input Schema:**
```typescript
{
network: string,
address: string,
sourceCode: string,
compilerVersion: string,
constructorArgs?: string
}
```
---
## 🛡️ MEV Protection
### `send_private_transaction`
**Complexity:** ⭐⭐⭐⭐ (4/5)
Send transaction via Flashbots Protect.
**Input Schema:**
```typescript
{
network: string,
to: string,
value?: string,
data?: string,
privateKey: string
}
```
---
### `submit_bundle`
**Complexity:** ⭐⭐⭐⭐⭐ (5/5)
Submit a transaction bundle to Flashbots.
**Input Schema:**
```typescript
{
network: string,
transactions: string[], // signed txs
targetBlock: number
}
```
---
### `simulate_bundle`
**Complexity:** ⭐⭐⭐ (3/5)
Simulate a bundle execution.
**Input Schema:**
```typescript
{
network: string,
transactions: string[],
blockNumber: number
}
```
---
## 📰 Crypto News
### `news_get_latest`
**Complexity:** ⭐ (1/5)
Get latest crypto news from 7 sources.
**Input Schema:**
```typescript
{
limit?: number,
source?: string
}
```
---
### `news_search`
**Complexity:** ⭐ (1/5)
Search crypto news by keywords.
**Input Schema:**
```typescript
{
keywords: string,
limit?: number
}
```
---
### `news_get_defi`
**Complexity:** ⭐ (1/5)
Get DeFi-specific news.
**Input Schema:**
```typescript
{
limit?: number
}
```
---
### `news_get_breaking`
**Complexity:** ⭐ (1/5)
Get breaking/urgent news.
**Input Schema:**
```typescript
{
limit?: number
}
```
---
## 🔗 Skill Chains
### Portfolio Health Check Chain
**Skills:** `get_balance` → `get_wallet_portfolio` → `security_check_approvals` → `get_lending_position`
```mermaid
flowchart LR
A[get_balance] --> B[get_wallet_portfolio]
B --> C[security_check_approvals]
C --> D[get_lending_position]
D --> E[Portfolio Report]
```
### Find Best Yield Chain
**Skills:** `defi_get_yields` → `defi_get_protocol` → `get_lending_rates` → `security_check_token`
```mermaid
flowchart LR
A[defi_get_yields] --> B[Filter & Sort]
B --> C[defi_get_protocol]
C --> D[security_check_token]
D --> E[Yield Recommendations]
```
### Token Security Audit Chain
**Skills:** `security_check_token` → `detect_honeypot` → `check_rug_risk` → `dex_get_token_pools`
```mermaid
flowchart LR
A[security_check_token] --> B[detect_honeypot]
B --> C[check_rug_risk]
C --> D[dex_get_token_pools]
D --> E[Security Report]
```
### Market Analysis Chain
**Skills:** `market_get_trending` → `social_get_coin_metrics` → `dex_get_token_details` → `market_get_ohlcv`
```mermaid
flowchart LR
A[market_get_trending] --> B[social_get_coin_metrics]
B --> C[dex_get_token_details]
C --> D[market_get_ohlcv]
D --> E[Market Report]
```
### Cross-Chain Bridge Chain
**Skills:** `get_bridge_quote` → `approve_token` → `execute_bridge` → `get_bridge_status`
```mermaid
flowchart LR
A[get_bridge_quote] --> B[approve_token]
B --> C[execute_bridge]
C --> D[get_bridge_status]
D --> E[Bridge Complete]
```
### DeFi Position Management Chain
**Skills:** `get_lending_position` → `lending_supply` → `lending_borrow` → `get_swap_quote` → `execute_swap`
```mermaid
flowchart LR
A[get_lending_position] --> B[lending_supply]
B --> C[lending_borrow]
C --> D[get_swap_quote]
D --> E[execute_swap]
E --> F[Position Optimized]
```
---
## 📋 Data Sources
| Provider | Type | API Key | Rate Limit |
|----------|------|---------|------------|
| CoinGecko | Market Data | Optional | 50/min (free) |
| CoinStats | Portfolio | Required | Varies |
| DefiLlama | DeFi Analytics | No | Unlimited |
| LunarCrush | Social | Required | 100/day (free) |
| GoPlus | Security | No | 100/min |
| GeckoTerminal | DEX Data | No | 30/min |
| DexPaprika | DEX Analytics | No | 100/min |
---
## 🏷️ Tags
`blockchain` `defi` `web3` `bnb-chain` `bsc` `opbnb` `greenfield` `sperax` `usds` `arbitrum` `polygon` `trading` `analytics` `security` `nft` `cross-chain` `lending` `staking` `governance` `market-data` `social-sentiment` `mev-protection` `portfolio`
---
## 📜 License
Apache-2.0 License - Built by **[nich](https://x.com/nichxbt)**
```
---
## Skill Companion Files
> Additional files collected from the skill directory layout.
### README.md
```markdown
<div align="center">
```
██████╗ ███╗ ██╗██████╗ ██████╗██╗ ██╗ █████╗ ██╗███╗ ██╗
██╔══██╗████╗ ██║██╔══██╗ ██╔════╝██║ ██║██╔══██╗██║████╗ ██║
██████╔╝██╔██╗ ██║██████╔╝ ██║ ███████║███████║██║██╔██╗ ██║
██╔══██╗██║╚██╗██║██╔══██╗ ██║ ██╔══██║██╔══██║██║██║╚██╗██║
██████╔╝██║ ╚████║██████╔╝ ╚██████╗██║ ██║██║ ██║██║██║ ╚████║
╚═════╝ ╚═╝ ╚═══╝╚═════╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝
███╗ ███╗ ██████╗██████╗ ███████╗███████╗██████╗ ██╗ ██╗███████╗██████╗
████╗ ████║██╔════╝██╔══██╗ ██╔════╝██╔════╝██╔══██╗██║ ██║██╔════╝██╔══██╗
██╔████╔██║██║ ██████╔╝ ███████╗█████╗ ██████╔╝██║ ██║█████╗ ██████╔╝
██║╚██╔╝██║██║ ██╔═══╝ ╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██╔══╝ ██╔══██╗
██║ ╚═╝ ██║╚██████╗██║ ███████║███████╗██║ ██║ ╚████╔╝ ███████╗██║ ██║
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝
```
<h1>BNB Chain MCP Server</h1>
<p><strong>The most comprehensive Model Context Protocol server for BNB Chain & EVM blockchains</strong></p>
<p>Enable AI agents to interact with BNB Chain, opBNB, and other EVM networks through natural language</p>
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://www.typescriptlang.org/)
[](https://www.bnbchain.org)
<br/>
[](https://www.bnbchain.org)
[](https://opbnb.bnbchain.org)
<br/>
<!-- Animated Demo -->
<img src="assets/demo.svg" alt="BNB Chain MCP Demo" width="800">
<br/><br/>
> ⭐ **If you find this useful, please star the repo!** It helps others discover this project.
<br/>
[📖 Documentation](https://bnb-chain-mcp.vercel.app) • [🚀 Quick Start](#-quick-start) • [🛠️ Features](#-features-overview) • [📊 Roadmap](#️-roadmap) • [🤝 Contributing](#-contributing)
</div>
---
## 📋 Table of Contents
- [What is BNB Chain MCP?](#-what-is-bnb-chain-mcp)
- [Quick Start](#-quick-start)
- [Features Overview](#-features-overview)
- [Supported Networks](#-supported-networks)
- [Installation](#-installation)
- [Configuration](#-configuration)
- [Data Sources](#-data-sources)
- [Example Conversations](#-example-conversations)
- [Architecture](#-architecture)
- [Roadmap](#️-roadmap)
- [Related MCP Servers](#-related-mcp-servers)
- [Troubleshooting](#-troubleshooting)
- [Contributing](#-contributing)
- [License](#-license)
---
## 🌟 What is BNB Chain MCP?
**BNB Chain MCP** is a Model Context Protocol (MCP) server optimized for BNB Chain and opBNB, while also supporting other EVM-compatible blockchains. It enables AI assistants like Claude, ChatGPT, and Cursor to interact with blockchain networks through natural language.
### Why BNB Chain MCP?
```
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ User: "What's the current price of ETH and show me the best DEX pools" │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ AI Assistant (Claude/ChatGPT) │ │
│ │ │ │
│ │ "Let me check that for you..." │ │
│ └────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ BNB Chain MCP Server │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │CoinGecko │ │GeckoTerm │ │DefiLlama │ ... │ │
│ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │
│ └────────┼─────────────┼─────────────┼──────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Blockchain Networks │ │
│ │ BNB Chain │ Ethereum │ Arbitrum │ Polygon │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
```
### Key Benefits
| Benefit | Description |
|---------|-------------|
| **Natural Language** | Ask questions in plain English, get blockchain data instantly |
| **Multi-Chain** | One server supports 10+ EVM networks simultaneously |
| **Read + Write** | Query data or execute transactions (with wallet) |
| **Security Built-In** | GoPlus integration for token/contract safety checks |
| **Rich Data** | Prices, DEX pools, TVL, social sentiment, news & more |
| **AI-Native** | Built specifically for LLMs with structured responses |
### Use Cases
<details>
<summary><strong>🔍 Research & Analysis</strong></summary>
- Check token prices and historical data
- Analyze DEX liquidity pools
- Monitor protocol TVL and metrics
- Research new tokens before investing
- Track whale wallets and movements
</details>
<details>
<summary><strong>💹 Trading & DeFi</strong></summary>
- Get swap quotes across DEX aggregators
- Find best yield farming opportunities
- Monitor lending rates on Aave/Compound
- Execute token swaps and transfers
- Bridge tokens across chains
</details>
<details>
<summary><strong>🛡️ Security & Compliance</strong></summary>
- Detect honeypot tokens
- Check for rug pull risks
- Verify smart contract safety
- Screen wallet addresses
- Check token holder distribution
</details>
<details>
<summary><strong>👨💻 Development</strong></summary>
- Deploy and verify smart contracts
- Query contract state and events
- Test transactions before execution
- Manage multi-sig operations
- Debug failed transactions
</details>
<br/>
<div align="center">
<img src="assets/demo-defi.svg" alt="BNB Chain MCP DeFi Demo" width="800">
<p><em>DeFi tools in action: swap quotes, TVL tracking, and more</em></p>
</div>
---
## 🚀 Quick Start
Get up and running in under 60 seconds!
### Option 1: Claude Desktop (Recommended)
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"bnb-chain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
}
}
}
```
<details>
<summary>📁 Config file locations</summary>
| OS | Path |
|----|------|
| **macOS** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| **Windows** | `%APPDATA%\Claude\claude_desktop_config.json` |
| **Linux** | `~/.config/claude/claude_desktop_config.json` |
</details>
### Option 2: Cursor / VS Code
Add to your MCP settings:
```json
{
"mcpServers": {
"bnb-chain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
}
}
}
```
### Option 3: ChatGPT Developer Mode
1. Enable [Developer Mode](https://chatgpt.com/#settings/Connectors/Advanced) in ChatGPT settings
2. Start the HTTP server:
```bash
npx @nirholas/bnb-chain-mcp@latest --http
```
3. In ChatGPT Settings → Apps, click **Create app**
4. Enter your server URL: `http://localhost:3001/mcp`
5. Select the app in conversations via **Developer mode** menu
📖 [Full ChatGPT Setup Guide](https://bnb-chain-mcp.vercel.app/mcp-server/chatgpt-setup/)
### Option 4: npx Instant Start
```bash
# stdio mode (Claude, Cursor)
npx @nirholas/bnb-chain-mcp@latest
# HTTP mode (ChatGPT Developer Mode)
npx @nirholas/bnb-chain-mcp@latest --http
# SSE mode (legacy clients)
npx @nirholas/bnb-chain-mcp@latest --sse
```
---
## 🛠️ Features Overview
### Feature Matrix
| Category | Features | Status |
|----------|----------|--------|
| **Swap/DEX** | Token swaps via 1inch, 0x, ParaSwap | ✅ |
| **Bridge** | Cross-chain transfers via LayerZero, Stargate | ✅ |
| **Gas** | Gas prices across chains, EIP-1559 suggestions | ✅ |
| **Multicall** | Batch read/write operations | ✅ |
| **Events/Logs** | Query historical events, decode logs | ✅ |
| **Security** | Rug pull detection, honeypot check, GoPlus integration | ✅ |
| **Staking** | Liquid staking (Lido), LP farming | ✅ |
| **Signatures** | Sign messages, verify signatures, EIP-712 | ✅ |
| **Lending** | Aave/Compound positions, borrow rates | ✅ |
| **Price Feeds** | Historical prices, TWAP, oracle aggregation | ✅ |
| **Portfolio** | Track holdings across chains | ✅ |
| **Governance** | Snapshot votes, on-chain proposals | ✅ |
| **Deployment** | Deploy contracts, CREATE2, upgradeable proxies | ✅ |
| **MEV Protection** | Flashbots Protect, private transactions | ✅ |
| **ENS/Domains** | Register, transfer, renew, set records | ✅ |
| **Market Data** | CoinGecko prices, OHLCV, trending | ✅ |
| **DeFi Analytics** | DefiLlama TVL, yields, fees, protocols | ✅ |
| **Social Sentiment** | LunarCrush metrics, influencers, trending | ✅ |
| **DEX Analytics** | GeckoTerminal pools, trades, OHLCV | ✅ |
### Tool Categories
<details>
<summary><strong>🔗 Core Blockchain (45+ tools)</strong></summary>
| Tool | Description |
|------|-------------|
| `get_chain_info` | Get chain ID, block number, gas price |
| `get_block` | Get block by number or hash |
| `get_transaction` | Get transaction details and receipt |
| `send_transaction` | Send native token transfer |
| `estimate_gas` | Estimate gas for transaction |
| `get_balance` | Get native/token balance |
| `call_contract` | Call view/pure contract functions |
| ... | [See full list →](https://bnb-chain-mcp.vercel.app/tools/blockchain) |
</details>
<details>
<summary><strong>💰 Token Operations (30+ tools)</strong></summary>
| Tool | Description |
|------|-------------|
| `get_token_info` | Get name, symbol, decimals, supply |
| `get_token_balance` | Get token balance for address |
| `transfer_token` | Transfer ERC-20 tokens |
| `approve_token` | Approve spending allowance |
| `get_nft_metadata` | Get NFT metadata and traits |
| `transfer_nft` | Transfer ERC-721 NFT |
| ... | [See full list →](https://bnb-chain-mcp.vercel.app/tools/tokens) |
</details>
<details>
<summary><strong>🏦 DeFi (50+ tools)</strong></summary>
| Tool | Description |
|------|-------------|
| `get_swap_quote` | Get swap quote from DEX aggregators |
| `execute_swap` | Execute token swap |
| `add_liquidity` | Add liquidity to DEX pools |
| `get_lending_rates` | Get Aave/Compound rates |
| `supply_to_lending` | Supply assets to lending protocol |
| `get_farming_apy` | Get yield farming APY |
| ... | [See full list →](https://bnb-chain-mcp.vercel.app/tools/defi) |
</details>
<details>
<summary><strong>🔒 Security (15+ tools)</strong></summary>
| Tool | Description |
|------|-------------|
| `check_token_security` | GoPlus token security analysis |
| `detect_honeypot` | Check if token is honeypot |
| `check_rug_pull` | Assess rug pull risk |
| `get_holder_distribution` | Get top holder breakdown |
| `check_contract_verified` | Verify contract source |
| `screen_address` | Check address risk score |
| ... | [See full list →](https://bnb-chain-mcp.vercel.app/tools/security) |
</details>
<details>
<summary><strong>📊 Market Data (25+ tools)</strong></summary>
| Tool | Description |
|------|-------------|
| `get_price` | Get current token price |
| `get_price_history` | Get historical OHLCV data |
| `get_trending_coins` | Get trending tokens |
| `get_tvl` | Get protocol TVL from DefiLlama |
| `get_dex_pools` | Get DEX pool data |
| `get_social_metrics` | Get LunarCrush sentiment |
| ... | [See full list →](https://bnb-chain-mcp.vercel.app/tools/market-data) |
</details>
---
## 🌐 Supported Networks
| Network | Chain ID | Native Token | Status |
|---------|----------|--------------|--------|
| **BNB Smart Chain** | 56 | BNB | ✅ Full Support |
| **opBNB** | 204 | BNB | ✅ Full Support |
| **Arbitrum One** | 42161 | ETH | ✅ Full Support |
| **Ethereum** | 1 | ETH | ✅ Full Support |
| **Polygon** | 137 | MATIC | ✅ Full Support |
| **Base** | 8453 | ETH | ✅ Full Support |
| **Optimism** | 10 | ETH | ✅ Full Support |
| **Avalanche C-Chain** | 43114 | AVAX | ✅ Full Support |
| **Fantom** | 250 | FTM | ✅ Full Support |
| **Gnosis** | 100 | xDAI | ✅ Full Support |
| **BSC Testnet** | 97 | tBNB | ✅ Testnet |
| **Sepolia** | 11155111 | SepoliaETH | ✅ Testnet |
| **Goerli** | 5 | GoerliETH | ✅ Testnet |
### Adding Custom Networks
```json
{
"mcpServers": {
"bnb-chain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
"env": {
"CUSTOM_RPC_56": "https://your-bnb-rpc.com",
"CUSTOM_RPC_1": "https://your-eth-rpc.com"
}
}
}
}
```
---
## 📦 Installation
### Server Modes
| Mode | Command | Use Case |
|------|---------|----------|
| **stdio** | `npx @nirholas/bnb-chain-mcp` | Claude Desktop, Cursor |
| **HTTP** | `npx @nirholas/bnb-chain-mcp --http` | ChatGPT Developer Mode |
| **SSE** | `npx @nirholas/bnb-chain-mcp --sse` | Legacy HTTP clients |
### From npm (Recommended)
```bash
# Run directly with npx (no install required)
npx @nirholas/bnb-chain-mcp@latest
# Or install globally
npm install -g @nirholas/bnb-chain-mcp
# Then run
bnb-chain-mcp
```
### From Source
```bash
# Clone
git clone https://github.com/nirholas/bnb-chain-mcp
cd bnb-chain-mcp
# Install dependencies
bun install
# Build
bun run build
# Run dev server (stdio - Claude)
bun dev
# Run dev server (HTTP - ChatGPT)
bun dev:http
# Run dev server (SSE - legacy)
bun dev:sse
```
### Docker
```bash
# Build
docker build -t bnb-chain-mcp .
# Run stdio mode
docker run -it bnb-chain-mcp
# Run HTTP mode
docker run -p 3001:3001 bnb-chain-mcp --http
```
---
## ⚙️ Configuration
### Environment Variables
| Variable | Description | Default | Required |
|----------|-------------|---------|----------|
| `PRIVATE_KEY` | Wallet private key for transactions | - | No (read-only without) |
| `COINGECKO_API_KEY` | CoinGecko Pro API key | - | No |
| `COINSTATS_API_KEY` | CoinStats API key | - | No |
| `LUNARCRUSH_API_KEY` | LunarCrush API key | - | No |
| `CRYPTOPANIC_API_KEY` | CryptoPanic news API key | - | No |
| `CUSTOM_RPC_<CHAIN_ID>` | Custom RPC for specific chain | - | No |
| `PORT` | HTTP server port | 3001 | No |
| `LOG_LEVEL` | Logging level | info | No |
### Full Configuration Example
```json
{
"mcpServers": {
"bnb-chain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
"env": {
"PRIVATE_KEY": "0x...",
"COINGECKO_API_KEY": "CG-xxx",
"LUNARCRUSH_API_KEY": "xxx",
"CUSTOM_RPC_56": "https://bsc-rpc.publicnode.com",
"CUSTOM_RPC_1": "https://eth-rpc.publicnode.com",
"LOG_LEVEL": "debug"
}
}
}
}
```
### Claude Desktop Configuration
<details>
<summary><strong>macOS</strong></summary>
```bash
# Open config file
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
</details>
<details>
<summary><strong>Windows</strong></summary>
```powershell
# Open config file
notepad %APPDATA%\Claude\claude_desktop_config.json
```
</details>
<details>
<summary><strong>Linux</strong></summary>
```bash
# Open config file
nano ~/.config/claude/claude_desktop_config.json
```
</details>
---
## 📊 Data Sources
This MCP server integrates with the following APIs:
| Provider | Data Type | API Key | Rate Limits |
|----------|-----------|---------|-------------|
| [CoinGecko](https://coingecko.com) | Market data, prices, OHLCV | Optional | 10-50 req/min |
| [CoinStats](https://coinstats.app) | Portfolio, prices, wallets | Required | Varies |
| [DefiLlama](https://defillama.com) | TVL, yields, fees, protocols | No | Generous |
| [LunarCrush](https://lunarcrush.com) | Social sentiment, influencers | Required | Varies |
| [GoPlus](https://gopluslabs.io) | Security analysis, honeypot | No | Generous |
| [GeckoTerminal](https://geckoterminal.com) | DEX pools, trades, OHLCV | No | Generous |
| [DexPaprika](https://dexpaprika.com) | DEX analytics, pools | No | Generous |
| [CryptoPanic](https://cryptopanic.com) | Crypto news | Required | Varies |
| [Alternative.me](https://alternative.me) | Fear & Greed Index | No | Generous |
---
## 💬 Example Conversations
### Price Queries
> **User:** "What's the current price of BNB?"
>
> **AI:** *Uses `get_price` tool* → "BNB is currently trading at $XXX.XX, up 2.5% in the last 24 hours."
### Security Checks
> **User:** "Is this token safe? 0x..."
>
> **AI:** *Uses `check_token_security` and `detect_honeypot`* → "⚠️ Warning: This token has several red flags..."
### DEX Analysis
> **User:** "Show me the best BNB liquidity pools"
>
> **AI:** *Uses `get_dex_pools`* → "Here are the top pools on BNB Chain by TVL..."
### Multi-Chain Portfolio
> **User:** "Check my wallet across all chains: 0x..."
>
> **AI:** *Uses `get_portfolio`* → "Your total portfolio value is $X across 5 chains..."
### DeFi Research
> **User:** "What are the best yield farming opportunities on BNB Chain?"
>
> **AI:** *Uses `get_yield_farms` and `get_tvl`* → "Here are the top yield opportunities..."
---
## 🏗️ Architecture
```
┌──────────────────────────────────────────────────────────────────────────────┐
│ BNB Chain MCP Server │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ stdio │ │ HTTP │ │ SSE │ Transport Layer │
│ │ (Claude) │ │ (ChatGPT) │ │ (Legacy) │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └─────────────────┼─────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ MCP Protocol Handler │ │
│ │ Tools Registration | Resource Management | Prompt Templates │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────┼─────────────────┐ │
│ ▼ ▼ ▼ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ Blockchain │ │ Market │ │ Security │ Tool Categories │
│ │ Tools │ │ Data │ │ Tools │ │
│ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ Provider Integrations │ │
│ │ viem | CoinGecko | DefiLlama | GoPlus | LunarCrush | GeckoTerminal │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ EVM Networks │ │
│ │ BNB Chain | Ethereum | Arbitrum | Polygon | Base | Optimism | ... │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
```
### Module Organization
```
src/
├── index.ts # Entry point
├── server/
│ ├── stdio.ts # stdio transport
│ ├── http.ts # HTTP transport
│ └── sse.ts # SSE transport
├── tools/
│ ├── blockchain/ # Core chain operations
│ ├── tokens/ # Token operations
│ ├── defi/ # DeFi protocols
│ ├── security/ # Security checks
│ ├── market/ # Market data
│ └── social/ # Social sentiment
├── providers/
│ ├── coingecko.ts # CoinGecko API
│ ├── defillama.ts # DefiLlama API
│ ├── goplus.ts # GoPlus Security
│ └── ...
└── utils/
├── chains.ts # Chain configurations
├── abi.ts # Common ABIs
└── format.ts # Formatters
```
---
## 🔐 Security
### Security Model
| Feature | Description |
|---------|-------------|
| **Read-Only Mode** | Without `PRIVATE_KEY`, server only reads blockchain state |
| **No Key Storage** | Private keys are never stored, only used in memory |
| **Input Validation** | All inputs validated with Zod schemas |
| **Rate Limiting** | Built-in rate limiting prevents API abuse |
| **Verified Sources** | Only uses reputable data providers |
### Best Practices
- ⚠️ **Never share** your `PRIVATE_KEY` in public configs
- ✅ Use environment variables or secrets management
- ✅ Use read-only mode when possible
- ✅ Always verify token safety before interacting
- ✅ Review transaction simulations before executing
---
## ❓ Troubleshooting
<details>
<summary><strong>Server won't start</strong></summary>
1. Check Node.js version (requires 18+):
```bash
node --version
```
2. Clear npx cache:
```bash
npx clear-npx-cache
```
3. Try installing globally:
```bash
npm install -g @nirholas/bnb-chain-mcp
```
</details>
<details>
<summary><strong>Claude Desktop doesn't see the server</strong></summary>
1. Verify config file location and JSON syntax
2. Restart Claude Desktop completely
3. Check logs:
- macOS: `~/Library/Logs/Claude/mcp*.log`
- Windows: `%APPDATA%\Claude\logs\mcp*.log`
</details>
<details>
<summary><strong>RPC errors / Rate limiting</strong></summary>
1. Use a dedicated RPC provider (Alchemy, QuickNode, etc.)
2. Configure custom RPC:
```json
"env": {
"CUSTOM_RPC_56": "https://your-dedicated-rpc.com"
}
```
</details>
<details>
<summary><strong>API key errors</strong></summary>
1. Verify API key is correct (no extra spaces)
2. Check API key has required permissions
3. Verify rate limits haven't been exceeded
</details>
---
## 🗺️ Roadmap
A comprehensive roadmap of all crypto/blockchain/DeFi/Web3 features to be implemented.
### Legend
- ✅ Implemented
- 🚧 In Progress
- 📋 Planned
---
### 🔗 Core Blockchain Operations
#### Network & Chain
| Feature | Status |
|---------|--------|
| Get chain ID, block number, gas price | ✅ |
| Get network status/health | ✅ |
| Switch networks/chains | ✅ |
| Get supported networks list | ✅ |
| Get RPC endpoints | ✅ |
| Estimate block time | ✅ |
| Get chain metadata (name, symbol, explorers) | ✅ |
| Get finality status | ✅ |
| Get mempool/pending transactions | ✅ |
| Get network peers/nodes | ✅ |
| Get gas oracle | ✅ |
#### Blocks
| Feature | Status |
|---------|--------|
| Get block by number/hash | ✅ |
| Get latest block | ✅ |
| Get block transactions | ✅ |
| Get block receipts | ✅ |
| Get uncle blocks | ✅ |
| Subscribe to new blocks | 📋 |
| Get block rewards | ✅ |
| Get block gas used/limit | ✅ |
| Get block range | ✅ |
| Get blocks by miner | ✅ |
#### Transactions
| Feature | Status |
|---------|--------|
| Send transaction | ✅ |
| Get transaction by hash | ✅ |
| Get transaction receipt | ✅ |
| Get transaction status | ✅ |
| Estimate gas | ✅ |
| Speed up transaction (replace with higher gas) | ✅ |
| Cancel transaction | ✅ |
| Decode transaction input | ✅ |
| Simulate transaction | ✅ |
| Get transaction trace | 📋 |
| Get internal transactions | 📋 |
| Batch transactions | ✅ |
| Get pending transactions | ✅ |
| Get transaction history by address | ✅ |
#### Accounts/Wallets
| Feature | Status |
|---------|--------|
| Get balance (native/token) | ✅ |
| Get nonce | ✅ |
| Get transaction count | ✅ |
| Create wallet | ✅ |
| Import wallet (private key/mnemonic) | ✅ |
| Export private key | 📋 |
| Sign message | ✅ |
| Verify signature | ✅ |
| Get address from private key | ✅ |
| Generate mnemonic | ✅ |
| Derive addresses (HD wallet) | ✅ |
| Multi-sig wallet operations | 📋 |
| Get wallet permissions | 📋 |
| Revoke approvals | ✅ |
| Account abstraction (ERC-4337) | 📋 |
| Social recovery | 📋 |
| Hardware wallet integration | 📋 |
| Get wallet portfolio | ✅ |
| Get token approvals | ✅ |
---
### 💰 Token Operations
#### Native Tokens
| Feature | Status |
|---------|--------|
| Get native balance | ✅ |
| Transfer native tokens | ✅ |
| Wrap/unwrap native tokens (WETH, WBNB) | ✅ |
#### ERC-20 (Fungible Tokens)
| Feature | Status |
|---------|--------|
| Get token info (name, symbol, decimals, total supply) | ✅ |
| Get token balance | ✅ |
| Transfer tokens | ✅ |
| Approve spending | ✅ |
| Get allowance | ✅ |
| Transfer from (delegated) | ✅ |
| Burn tokens | ✅ |
| Mint tokens | ✅ |
| Get token holders | ✅ |
| Get token transfers | ✅ |
| Permit (gasless approvals - EIP-2612) | ✅ |
| Batch transfers | ✅ |
| Token snapshots | 📋 |
| Get token supply info | ✅ |
| Check/revoke token approval | ✅ |
#### ERC-721 (NFTs)
| Feature | Status |
|---------|--------|
| Get NFT metadata | ✅ |
| Get NFT owner | ✅ |
| Transfer NFT | ✅ |
| Approve NFT | ✅ |
| Set approval for all | ✅ |
| Get NFTs by owner | ✅ |
| Get NFT collection info | ✅ |
| Mint NFT | 📋 |
| Burn NFT | 📋 |
| Get NFT transfer history | 📋 |
| Get NFT traits/attributes | ✅ |
| Get NFT rarity | 📋 |
| Verify NFT authenticity | 📋 |
| Batch transfer NFTs | ✅ |
| Check NFT approval | ✅ |
| Revoke NFT approval | ✅ |
| Approve for marketplace | ✅ |
| Fetch NFT metadata from URI | ✅ |
#### ERC-1155 (Multi-Token)
| Feature | Status |
|---------|--------|
| Get token balance (fungible + NFT) | ✅ |
| Batch transfers | 📋 |
| Batch balance queries | 📋 |
| Safe transfer | ✅ |
| Get URI | ✅ |
#### Other Token Standards
| Feature | Status |
|---------|--------|
| ERC-777 (advanced fungible) | 📋 |
| ERC-3525 (semi-fungible) | 📋 |
| ERC-4626 (tokenized vaults) | 📋 |
| ERC-6551 (token-bound accounts) | 📋 |
| ERC-404 (hybrid tokens) | 📋 |
| Soulbound tokens (SBTs) | 📋 |
---
### 🏦 DeFi - Decentralized Exchanges (DEX)
#### Swaps
| Feature | Status |
|---------|--------|
| Get quote/price | ✅ |
| Swap exact tokens for tokens | ✅ |
| Swap tokens for exact tokens | ✅ |
| Multi-hop swaps | ✅ |
| Split route swaps | 📋 |
| Cross-DEX aggregation | ✅ |
| Limit orders | 📋 |
| TWAP orders (time-weighted) | 📋 |
| Stop-loss orders | 📋 |
| Get slippage estimate | ✅ |
| Get price impact | ✅ |
| MEV protection (private transactions) | 📋 |
#### DEX Analytics
| Feature | Status |
|---------|--------|
| Get trending pools | ✅ |
| Get new pools | ✅ |
| Get top pools by volume | ✅ |
| Get pool OHLCV data | ✅ |
| Get pool trades | ✅ |
| Get token pools | ✅ |
| Get DEX list | ✅ |
| Search pools cross-chain | ✅ |
| Get token price by contract | ✅ |
| Get pool transactions | ✅ |
| Multi-token price lookup | ✅ |
#### Liquidity Provision
| Feature | Status |
|---------|--------|
| Add liquidity | ✅ |
| Remove liquidity | ✅ |
| Get LP token balance | ✅ |
| Get pool reserves | ✅ |
| Get pool APY/APR | 📋 |
| Get impermanent loss estimate | 📋 |
| Concentrated liquidity (Uniswap V3) | 📋 |
| Set price range | 📋 |
| Collect fees | 📋 |
| Rebalance position | 📋 |
| Add liquidity with native token | ✅ |
| Calculate arbitrage opportunities | ✅ |
#### AMM Types Support
| Feature | Status |
|---------|--------|
| Constant product (x*y=k) | ✅ |
| Stable swap (Curve) | 📋 |
| Concentrated liquidity | 📋 |
| Order book hybrid | 📋 |
| Virtual AMM (perpetuals) | 📋 |
---
### 🏦 DeFi - Lending & Borrowing
#### Lending
| Feature | Status |
|---------|--------|
| Supply/deposit assets | ✅ |
| Withdraw assets | ✅ |
| Get supply APY | ✅ |
| Get supplied balance | ✅ |
| Get utilization rate | 📋 |
| Enable/disable as collateral | 📋 |
#### Borrowing
| Feature | Status |
|---------|--------|
| Borrow assets | ✅ |
| Repay debt | ✅ |
| Get borrow APY | ✅ |
| Get borrowed balance | ✅ |
| Get health factor | ✅ |
| Get liquidation threshold | ✅ |
| Get max borrowable amount | 📋 |
| Flash loans | ✅ |
| Get borrow limit | 📋 |
| Get flash loan info | ✅ |
#### Liquidations
| Feature | Status |
|---------|--------|
| Liquidate unhealthy positions | 📋 |
| Get liquidatable positions | ✅ |
| Get liquidation bonus | 📋 |
| Partial liquidations | 📋 |
#### Isolated Markets
| Feature | Status |
|---------|--------|
| Supply to isolated pool | 📋 |
| Borrow from isolated pool | 📋 |
| Get isolation mode debt ceiling | 📋 |
---
### 🥩 DeFi - Staking
#### Native Staking
| Feature | Status |
|---------|--------|
| Stake native tokens | ✅ |
| Unstake/withdraw | ✅ |
| Claim rewards | ✅ |
| Get staking APY | ✅ |
| Get validator list | 📋 |
| Delegate to validator | 📋 |
| Redelegate | 📋 |
| Get unbonding period | 📋 |
#### Liquid Staking
| Feature | Status |
|---------|--------|
| Stake for liquid staking tokens (stETH, rETH) | ✅ |
| Unwrap liquid staking tokens | ✅ |
| Get exchange rate | ✅ |
| Get staking rewards rate | ✅ |
#### LP Staking/Farming
| Feature | Status |
|---------|--------|
| Stake LP tokens | ✅ |
| Unstake LP tokens | ✅ |
| Claim farming rewards | ✅ |
| Get farming APY | ✅ |
| Compound rewards | 📋 |
| Get pending rewards | ✅ |
| Boost rewards (veTokens) | 📋 |
#### Restaking
| Feature | Status |
|---------|--------|
| Restake assets (EigenLayer) | 📋 |
| Get restaking points | 📋 |
| Choose operators | 📋 |
| Withdraw from restaking | 📋 |
---
### 📊 DeFi - Derivatives
#### Perpetual Futures
| Feature | Status |
|---------|--------|
| Open long/short position | 📋 |
| Close position | 📋 |
| Add/remove margin | 📋 |
| Set leverage | 📋 |
| Get funding rate | 📋 |
| Get open interest | 📋 |
| Get liquidation price | 📋 |
| Set stop-loss/take-profit | 📋 |
| Get PnL | 📋 |
| Partial close | 📋 |
#### Options
| Feature | Status |
|---------|--------|
| Buy call/put options | 📋 |
| Sell/write options | 📋 |
| Exercise options | 📋 |
| Get option greeks | 📋 |
| Get implied volatility | 📋 |
| Get option chain | 📋 |
| Spread strategies | 📋 |
#### Synthetics
| Feature | Status |
|---------|--------|
| Mint synthetic assets | 📋 |
| Burn synthetic assets | 📋 |
| Get collateral ratio | 📋 |
| Get synthetic price feed | 📋 |
| Liquidate synthetic positions | 📋 |
---
### 🌉 Cross-Chain & Bridges
#### Bridging
| Feature | Status |
|---------|--------|
| Bridge tokens cross-chain | ✅ |
| Get bridge quote | ✅ |
| Get bridge status | ✅ |
| Get supported chains | ✅ |
| Get supported tokens | ✅ |
| Claim bridged tokens | 📋 |
| Get bridge fees | ✅ |
| Get estimated time | ✅ |
#### Cross-Chain Messaging
| Feature | Status |
|---------|--------|
| Send cross-chain message | 📋 |
| Receive cross-chain message | 📋 |
| LayerZero operations | 📋 |
| Axelar operations | 📋 |
| Wormhole operations | 📋 |
| CCIP (Chainlink) | 📋 |
| Hyperlane operations | 📋 |
#### Atomic Swaps
| Feature | Status |
|---------|--------|
| Initiate atomic swap | 📋 |
| Complete atomic swap | 📋 |
| Refund atomic swap | 📋 |
---
### 🗳️ Governance
#### Voting
| Feature | Status |
|---------|--------|
| Create proposal | ✅ |
| Vote on proposal | ✅ |
| Delegate votes | ✅ |
| Get voting power | ✅ |
| Get proposal state | ✅ |
| Queue proposal | ✅ |
| Execute proposal | ✅ |
| Cancel proposal | ✅ |
| Get vote receipt | ✅ |
#### Token Locking
| Feature | Status |
|---------|--------|
| Lock tokens for voting (veTokens) | 📋 |
| Extend lock period | 📋 |
| Increase locked amount | 📋 |
| Withdraw unlocked tokens | 📋 |
| Get lock info | 📋 |
#### Snapshot (Off-chain)
| Feature | Status |
|---------|--------|
| Create space | 📋 |
| Create off-chain proposal | 📋 |
| Vote off-chain | 📋 |
| Get snapshot results | 📋 |
---
### 🔐 Security & Analysis
#### Contract Analysis
| Feature | Status |
|---------|--------|
| Verify contract source | ✅ |
| Get contract ABI | ✅ |
| Check if contract is proxy | ✅ |
| Get implementation address | ✅ |
| Detect honeypots | ✅ |
| Check for rug pull risks | ✅ |
| GoPlus token security check | ✅ |
| GoPlus rug pull detection | ✅ |
| Audit score | 📋 |
| Get contract creator | ✅ |
| Get contract age | ✅ |
| Detect malicious functions | ✅ |
#### Token Security
| Feature | Status |
|---------|--------|
| Check token safety | ✅ |
| Get holder distribution | ✅ |
| Check if mintable | ✅ |
| Check if pausable | ✅ |
| Check for hidden fees | ✅ |
| Check liquidity locked | ✅ |
| Get top holders | ✅ |
| Check ownership renounced | ✅ |
| GoPlus NFT security | ✅ |
| GoPlus approval security | ✅ |
#### Wallet Security
| Feature | Status |
|---------|--------|
| Get approval list | ✅ |
| Revoke approvals | ✅ |
| Check for drainers | ✅ |
| Simulate transaction safety | ✅ |
| Get wallet risk score | 📋 |
| GoPlus address security | ✅ |
| GoPlus dApp phishing check | ✅ |
| GoPlus signature decode | ✅ |
---
### 📈 Price & Market Data
#### Price Feeds
| Feature | Status |
|---------|--------|
| Get current price | ✅ |
| Get historical prices | ✅ |
| Get OHLCV data | ✅ |
| Get price from DEX | ✅ |
| Get price from oracle (Chainlink, Pyth) | ✅ |
| Get TWAP price | ✅ |
| Get price across exchanges | ✅ |
| Get volume | ✅ |
| Get market cap | ✅ |
| Get trending coins | ✅ |
| Get token by contract address | ✅ |
| Get exchange rates | ✅ |
| Get coin categories | ✅ |
| Get derivatives data | ✅ |
| Get company BTC/ETH holdings | ✅ |
#### Analytics
| Feature | Status |
|---------|--------|
| Get TVL (Total Value Locked) | ✅ |
| Get protocol metrics | ✅ |
| Get yield farming APYs | ✅ |
| Get gas tracker | ✅ |
| Get whale transactions | 📋 |
| Get token flow analysis | 📋 |
| Get DEX volume | ✅ |
| Get lending metrics | 📋 |
| Get DeFi fees & revenue | ✅ |
| Get stablecoin data | ✅ |
| Get bridge volumes | ✅ |
| Get liquidation data | ✅ |
| Get DeFi hacks history | ✅ |
| Get perpetuals data | ✅ |
---
### 🆔 Identity & Domains
#### ENS (Ethereum Name Service)
| Feature | Status |
|---------|--------|
| Register domain | ✅ |
| Resolve name to address | ✅ |
| Reverse resolve address to name | ✅ |
| Set primary name | 📋 |
| Set records (text, address, content hash) | ✅ |
| Transfer domain | ✅ |
| Renew domain | ✅ |
| Get expiry date | 📋 |
| Set subdomains | ✅ |
#### Other Name Services
| Feature | Status |
|---------|--------|
| Unstoppable Domains | 📋 |
| Space ID (.bnb) | 📋 |
| Bonfida (.sol) | 📋 |
| ANS (.avax) | 📋 |
#### DIDs & Verifiable Credentials
| Feature | Status |
|---------|--------|
| Create DID | 📋 |
| Resolve DID | 📋 |
| Issue verifiable credential | 📋 |
| Verify credential | 📋 |
| Revoke credential | 📋 |
---
### 🖼️ NFT & Metaverse
#### NFT Marketplace
| Feature | Status |
|---------|--------|
| List NFT for sale | 📋 |
| Buy NFT | 📋 |
| Make offer | 📋 |
| Accept offer | 📋 |
| Cancel listing | 📋 |
| Auction NFT | 📋 |
| Bid on auction | 📋 |
| Get floor price | 📋 |
| Get collection stats | 📋 |
#### NFT Creation
| Feature | Status |
|---------|--------|
| Deploy NFT collection | 📋 |
| Mint NFTs | 📋 |
| Set royalties | 📋 |
| Set metadata | 📋 |
| Reveal NFTs | 📋 |
| Whitelist management | 📋 |
| Airdrop NFTs | 📋 |
#### NFT Finance
| Feature | Status |
|---------|--------|
| NFT collateralized loans | 📋 |
| NFT fractionalization | 📋 |
| NFT renting | 📋 |
| NFT staking | 📋 |
#### Metaverse
| Feature | Status |
|---------|--------|
| Buy virtual land | 📋 |
| Sell virtual land | 📋 |
| Build on land | 📋 |
| Transfer assets between metaverses | 📋 |
---
### 🔔 Events & Subscriptions
#### Event Listening
| Feature | Status |
|---------|--------|
| Subscribe to contract events | 📋 |
| Subscribe to pending transactions | 📋 |
| Subscribe to new blocks | 📋 |
| Subscribe to logs | 📋 |
| Filter events by topic | ✅ |
| Get historical events | ✅ |
| Decode event logs | ✅ |
#### Webhooks & Notifications
| Feature | Status |
|---------|--------|
| Set up webhook for events | 📋 |
| Get transaction notifications | 📋 |
| Get price alerts | 📋 |
| Get whale alerts | 📋 |
| Get governance notifications | 📋 |
---
### 📜 Smart Contract Interaction
#### Read Operations
| Feature | Status |
|---------|--------|
| Call view/pure functions | ✅ |
| Get storage at slot | ✅ |
| Get contract bytecode | ✅ |
| Multicall (batch reads) | ✅ |
| Static call simulation | ✅ |
#### Write Operations
| Feature | Status |
|---------|--------|
| Send transaction to contract | ✅ |
| Encode function call | ✅ |
| Decode function result | ✅ |
| Estimate gas for call | ✅ |
| Batch transactions | ✅ |
#### Contract Deployment
| Feature | Status |
|---------|--------|
| Deploy contract | ✅ |
| Deploy with CREATE2 | ✅ |
| Deploy proxy contract | ✅ |
| Upgrade proxy | ✅ |
| Verify on explorer | ✅ |
---
### 🤖 Advanced Features
#### MEV & Flashbots
| Feature | Status |
|---------|--------|
| Submit private transaction | ✅ |
| Submit bundle | ✅ |
| Get MEV opportunities | ✅ |
| Backrun protection | ✅ |
| Frontrun protection | ✅ |
| Sandwich protection | ✅ |
#### Account Abstraction (ERC-4337)
| Feature | Status |
|---------|--------|
| Create smart account | 📋 |
| Execute user operation | 📋 |
| Batch operations | 📋 |
| Sponsor gas (Paymaster) | 📋 |
| Session keys | 📋 |
| Social recovery | 📋 |
#### Intents & Solvers
| Feature | Status |
|---------|--------|
| Submit intent | 📋 |
| Get solver quotes | 📋 |
| Execute via solver | 📋 |
#### Oracles
| Feature | Status |
|---------|--------|
| Get Chainlink price | ✅ |
| Get Pyth price | 📋 |
| Get Band Protocol price | 📋 |
| Get API3 price | 📋 |
| Request randomness (VRF) | 📋 |
| Request external data | 📋 |
---
### 🛠️ Utility Functions
#### Gas
| Feature | Status |
|---------|--------|
| Get gas price | ✅ |
| Get priority fee | ✅ |
| Get base fee | ✅ |
| Get gas history | ✅ |
| Estimate gas for transaction | ✅ |
| Get EIP-1559 fees | ✅ |
#### Encoding/Decoding
| Feature | Status |
|---------|--------|
| ABI encode | ✅ |
| ABI decode | ✅ |
| Keccak256 hash | ✅ |
| Pack/unpack data | ✅ |
| Sign typed data (EIP-712) | ✅ |
#### Address Utils
| Feature | Status |
|---------|--------|
| Validate address | ✅ |
| Checksum address | ✅ |
| Get address from ENS | ✅ |
| Check if contract | ✅ |
| Get contract type | 📋 |
---
### 📰 Data & Information
#### News & Social
| Feature | Status |
|---------|--------|
| Get crypto news | ✅ |
| Search crypto news | ✅ |
| Get DeFi news | ✅ |
| Get Bitcoin news | ✅ |
| Get breaking news | ✅ |
| Get social sentiment | ✅ |
| Get influencer rankings | ✅ |
| Get trending topics | ✅ |
| Get coin social metrics | ✅ |
| Get social feed | ✅ |
| Get market sentiment index | ✅ |
| Get Galaxy Score | ✅ |
| Get AltRank | ✅ |
| Get Twitter mentions | 📋 |
| Get Discord activity | 📋 |
| Get GitHub activity | 📋 |
#### On-Chain Data
| Feature | Status |
|---------|--------|
| Get token holders | 📋 |
| Get whale wallets | 📋 |
| Get smart money movements | 📋 |
| Get protocol users | 📋 |
| Get daily active addresses | 📋 |
| Get network hash rate | 📋 |
---
### 🏛️ Institutional & Compliance
#### KYC/AML
| Feature | Status |
|---------|--------|
| Wallet screening | 📋 |
| Transaction monitoring | 📋 |
| Risk scoring | 📋 |
| Sanctions checking | 📋 |
#### Custody
| Feature | Status |
|---------|--------|
| Multi-sig operations | 📋 |
| Cold storage | 📋 |
| Hot wallet management | 📋 |
| Policy enforcement | 📋 |
#### Reporting
| Feature | Status |
|---------|--------|
| Tax reporting | 📋 |
| Portfolio tracking | ✅ |
| P&L reporting | 📋 |
| Transaction history export | 📋 |
---
## Data Sources
This MCP server integrates with the following APIs:
| Provider | Data Type | API Key Required |
|----------|-----------|------------------|
| [CoinGecko](https://coingecko.com) | Market data, prices, OHLCV | Optional (free tier) |
| [CoinStats](https://coinstats.app) | Portfolio, prices, wallets | Yes |
| [DefiLlama](https://defillama.com) | TVL, yields, fees, protocols | No |
| [LunarCrush](https://lunarcrush.com) | Social sentiment, influencers | Yes |
| [GoPlus](https://gopluslabs.io) | Security analysis, honeypot detection | No |
| [GeckoTerminal](https://geckoterminal.com) | DEX pools, trades, OHLCV | No |
| [DexPaprika](https://dexpaprika.com) | DEX analytics, pools | No |
| [CryptoPanic](https://cryptopanic.com) | Crypto news | Yes |
| [Alternative.me](https://alternative.me) | Fear & Greed Index | No |
---
## 🔗 Related MCP Servers
Additional specialized MCP servers in this workspace:
| Server | Description | Tools |
|--------|-------------|-------|
| [binance-mcp-server](./binance-mcp-server/) | Binance.com global exchange API | 156+ tools |
| [binance-us-mcp-server](./binance-us-mcp-server/) | Binance.US exchange API | 71+ tools |
### Binance.com Server
Full Binance global API coverage including:
- Spot trading, wallet, staking, mining
- Convert, Simple Earn, Algo Trading (TWAP/VP)
- NFT, Pay, Copy Trading, Dual Investment
- VIP Loans, C2C/P2P, Fiat
```json
{
"mcpServers": {
"binance": {
"command": "npx",
"args": ["ts-node", "binance-mcp-server/src/index.ts"],
"env": {
"BINANCE_API_KEY": "your_key",
"BINANCE_API_SECRET": "your_secret"
}
}
}
}
```
### Binance.US Server
US-regulated exchange with:
- Market data, spot trading, wallet
- Staking, OTC, sub-accounts
- Custodial solutions (institutional)
```json
{
"mcpServers": {
"binance-us": {
"command": "node",
"args": ["binance-us-mcp-server/build/index.js"],
"env": {
"BINANCE_US_API_KEY": "your_key",
"BINANCE_US_API_SECRET": "your_secret"
}
}
}
}
```
---
## 🤝 Contributing
We welcome contributions! Here's how to get started:
### Development Setup
```bash
# Fork and clone
git clone https://github.com/YOUR_USERNAME/bnb-chain-mcp
cd bnb-chain-mcp
# Install dependencies
bun install
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and test
bun dev
bun test
# Commit and push
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature
# Open Pull Request
```
### Contribution Guidelines
- 📝 Follow existing code style
- ✅ Add tests for new features
- 📖 Update documentation
- 🔍 Run linting before committing
### Adding New Tools
1. Create tool file in `src/tools/<category>/`
2. Export tool definition with Zod schema
3. Add to tool index
4. Document in README
---
## 📄 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
---
## 🙏 Credits
Built by **[nich](https://x.com/nichxbt)** ([github.com/nirholas](https://github.com/nirholas))
### Special Thanks
- [Model Context Protocol](https://modelcontextprotocol.io) team
- [viem](https://viem.sh) for excellent EVM tooling
- All the amazing Web3 API providers
---
<div align="center">
### 🌟 Star us on GitHub!
If you find this project useful, please consider giving it a ⭐️
[](https://github.com/nirholas/bnb-chain-mcp)
<br/>
**Made with ❤️ for the Web3 & AI community**
<sub>Empowering AI agents to interact with blockchains</sub>
</div>
```
### assets/demo-defi.svg
```svg
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 450">
<defs>
<style>
@keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
@keyframes blink { 0%, 100% { opacity: 1; } 50% { opacity: 0; } }
@keyframes pulse { 0%, 100% { opacity: 0.8; } 50% { opacity: 1; } }
.terminal-bg { fill: #0d1117; }
.terminal-header { fill: #161b22; }
.title-bar { fill: #8b949e; font-family: 'SF Mono', Monaco, monospace; font-size: 12px; }
.prompt { fill: #f0b90b; font-family: 'SF Mono', Monaco, monospace; font-size: 14px; font-weight: bold; }
.command { fill: #e6edf3; font-family: 'SF Mono', Monaco, monospace; font-size: 14px; }
.response { fill: #8b949e; font-family: 'SF Mono', Monaco, monospace; font-size: 13px; }
.highlight { fill: #f0b90b; }
.success { fill: #3fb950; }
.info { fill: #58a6ff; }
.warning { fill: #d29922; }
.amount { fill: #a371f7; font-weight: bold; }
.cursor { fill: #f0b90b; animation: blink 1s step-end infinite; }
.bnb-logo { animation: pulse 2s ease-in-out infinite; }
.line1 { animation: fadeIn 0.5s ease-out 0.3s both; }
.line2 { animation: fadeIn 0.5s ease-out 1s both; }
.line3 { animation: fadeIn 0.5s ease-out 1.5s both; }
.line4 { animation: fadeIn 0.5s ease-out 2s both; }
.line5 { animation: fadeIn 0.5s ease-out 2.5s both; }
.line6 { animation: fadeIn 0.5s ease-out 3s both; }
.line7 { animation: fadeIn 0.5s ease-out 4s both; }
.line8 { animation: fadeIn 0.5s ease-out 4.5s both; }
.line9 { animation: fadeIn 0.5s ease-out 5s both; }
.line10 { animation: fadeIn 0.5s ease-out 5.5s both; }
.line11 { animation: fadeIn 0.5s ease-out 6s both; }
.line12 { animation: fadeIn 0.5s ease-out 6.5s both; }
.line13 { animation: fadeIn 0.5s ease-out 7s both; }
</style>
</defs>
<!-- Terminal Window -->
<rect class="terminal-bg" x="0" y="0" width="800" height="450" rx="12"/>
<!-- Terminal Header -->
<rect class="terminal-header" x="0" y="0" width="800" height="40" rx="12"/>
<rect class="terminal-bg" x="0" y="28" width="800" height="15"/>
<!-- Window Controls -->
<circle cx="20" cy="20" r="7" fill="#ff5f56"/>
<circle cx="44" cy="20" r="7" fill="#ffbd2e"/>
<circle cx="68" cy="20" r="7" fill="#27c93f"/>
<!-- BNB Logo in header -->
<g class="bnb-logo" transform="translate(750, 12)">
<circle cx="0" cy="8" r="12" fill="#f0b90b" opacity="0.2"/>
<text x="0" y="13" text-anchor="middle" fill="#f0b90b" font-size="14" font-weight="bold">₿</text>
</g>
<!-- Title -->
<text class="title-bar" x="400" y="25" text-anchor="middle">🔗 BNB Chain MCP — DeFi Tools Demo</text>
<!-- Terminal Content -->
<g transform="translate(25, 60)">
<!-- Prompt 1: Swap Quote -->
<g class="line1">
<text class="prompt" x="0" y="0">bnb-mcp ❯</text>
<text class="command" x="90" y="0">Get swap quote: 1 BNB → CAKE on PancakeSwap</text>
</g>
<!-- Response 1 -->
<g class="line2">
<text class="info" x="0" y="28">⚡ Fetching quote from PancakeSwap V3...</text>
</g>
<g class="line3">
<text class="response" x="0" y="56">┌─────────────────────────────────────────────┐</text>
</g>
<g class="line4">
<text class="response" x="0" y="80">│ 🔄 Swap Quote │</text>
</g>
<g class="line5">
<text class="response" x="0" y="104">│ </text>
<text class="highlight" x="25" y="104">1 BNB</text>
<text class="response" x="75" y="104"> → </text>
<text class="amount" x="100" y="104">245.67 CAKE</text>
<text class="response" x="215" y="104"> │</text>
</g>
<g class="line6">
<text class="response" x="0" y="128">│ Price Impact: </text>
<text class="success" x="115" y="128">0.12%</text>
<text class="response" x="165" y="128"> Gas: </text>
<text class="warning" x="210" y="128">~$0.08</text>
<text class="response" x="275" y="128"> │</text>
</g>
<g class="line7">
<text class="response" x="0" y="152">└─────────────────────────────────────────────┘</text>
</g>
<!-- Prompt 2: TVL Check -->
<g class="line8">
<text class="prompt" x="0" y="195">bnb-mcp ❯</text>
<text class="command" x="90" y="195">Show top DeFi protocols on BNB Chain by TVL</text>
</g>
<!-- Response 2 -->
<g class="line9">
<text class="info" x="0" y="223">📊 Fetching from DefiLlama...</text>
</g>
<g class="line10">
<text class="response" x="0" y="251">┌────────────────────┬────────────────┐</text>
</g>
<g class="line11">
<text class="response" x="0" y="275">│ Protocol │ TVL │</text>
</g>
<g class="line12">
<text class="response" x="0" y="299">├────────────────────┼────────────────┤</text>
<text class="highlight" x="5" y="323">│ 🥞 PancakeSwap │</text>
<text class="amount" x="172" y="323">$2.1B</text>
<text class="response" x="230" y="323"> │</text>
</g>
<g class="line13">
<text class="success" x="5" y="347">│ 🌙 Venus Protocol │</text>
<text class="amount" x="172" y="347">$1.4B</text>
<text class="response" x="230" y="347"> │</text>
<text class="info" x="5" y="371">│ 🔷 Alpaca Finance │</text>
<text class="amount" x="172" y="371">$312M</text>
<text class="response" x="230" y="371"> │</text>
<text class="response" x="0" y="395">└────────────────────┴────────────────┘</text>
</g>
</g>
<!-- Blinking Cursor -->
<rect class="cursor" x="25" y="420" width="12" height="3" rx="1"/>
</svg>
```
### assets/demo.svg
```svg
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 500">
<defs>
<style>
@keyframes typing1 { from { width: 0; } to { width: 420px; } }
@keyframes typing2 { from { width: 0; } to { width: 380px; } }
@keyframes typing3 { from { width: 0; } to { width: 350px; } }
@keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
@keyframes blink { 0%, 100% { opacity: 1; } 50% { opacity: 0; } }
.terminal-bg { fill: #1a1b26; }
.terminal-header { fill: #24283b; }
.title-bar { fill: #7aa2f7; font-family: 'SF Mono', Monaco, monospace; font-size: 12px; }
.prompt { fill: #9ece6a; font-family: 'SF Mono', Monaco, monospace; font-size: 14px; }
.command { fill: #c0caf5; font-family: 'SF Mono', Monaco, monospace; font-size: 14px; }
.response { fill: #a9b1d6; font-family: 'SF Mono', Monaco, monospace; font-size: 13px; }
.highlight { fill: #f7b83d; }
.success { fill: #9ece6a; }
.info { fill: #7dcfff; }
.price { fill: #bb9af7; }
.cursor { fill: #c0caf5; animation: blink 1s step-end infinite; }
.line1 { animation: fadeIn 0.5s ease-out 0.5s both; }
.line2 { animation: fadeIn 0.5s ease-out 1.5s both; }
.line3 { animation: fadeIn 0.5s ease-out 2s both; }
.line4 { animation: fadeIn 0.5s ease-out 2.5s both; }
.line5 { animation: fadeIn 0.5s ease-out 3s both; }
.line6 { animation: fadeIn 0.5s ease-out 4s both; }
.line7 { animation: fadeIn 0.5s ease-out 4.5s both; }
.line8 { animation: fadeIn 0.5s ease-out 5s both; }
.line9 { animation: fadeIn 0.5s ease-out 5.5s both; }
.line10 { animation: fadeIn 0.5s ease-out 6s both; }
.line11 { animation: fadeIn 0.5s ease-out 7s both; }
.line12 { animation: fadeIn 0.5s ease-out 7.5s both; }
.line13 { animation: fadeIn 0.5s ease-out 8s both; }
.line14 { animation: fadeIn 0.5s ease-out 8.5s both; }
.line15 { animation: fadeIn 0.5s ease-out 9s both; }
</style>
</defs>
<!-- Terminal Window -->
<rect class="terminal-bg" x="0" y="0" width="800" height="500" rx="10"/>
<!-- Terminal Header -->
<rect class="terminal-header" x="0" y="0" width="800" height="35" rx="10"/>
<rect class="terminal-bg" x="0" y="25" width="800" height="15"/>
<!-- Window Controls -->
<circle cx="20" cy="17" r="6" fill="#ff5f56"/>
<circle cx="40" cy="17" r="6" fill="#ffbd2e"/>
<circle cx="60" cy="17" r="6" fill="#27c93f"/>
<!-- Title -->
<text class="title-bar" x="400" y="22" text-anchor="middle">BNB Chain MCP Server — Claude Desktop</text>
<!-- Terminal Content -->
<g transform="translate(20, 55)">
<!-- Prompt 1: Check BNB Price -->
<g class="line1">
<text class="prompt" x="0" y="0">claude ▶</text>
<text class="command" x="70" y="0">What's the current price of BNB?</text>
</g>
<!-- Response 1 -->
<g class="line2">
<text class="info" x="0" y="25">🔍 Fetching BNB price from CoinGecko...</text>
</g>
<g class="line3">
<text class="response" x="0" y="50">📊 BNB (Binance Coin)</text>
</g>
<g class="line4">
<text class="price" x="0" y="75"> Price: $612.45 USD</text>
</g>
<g class="line5">
<text class="success" x="0" y="100"> 24h Change: +3.2% ▲</text>
</g>
<!-- Prompt 2: Check Wallet Balance -->
<g class="line6">
<text class="prompt" x="0" y="140">claude ▶</text>
<text class="command" x="70" y="140">Check my wallet balance on BSC: 0x742d...9f12</text>
</g>
<!-- Response 2 -->
<g class="line7">
<text class="info" x="0" y="165">🔗 Connecting to BNB Smart Chain (chainId: 56)...</text>
</g>
<g class="line8">
<text class="response" x="0" y="190">💰 Wallet Balance:</text>
</g>
<g class="line9">
<text class="highlight" x="0" y="215"> • 2.5 BNB ($1,531.12)</text>
</g>
<g class="line10">
<text class="highlight" x="0" y="240"> • 1,000 USDT</text>
</g>
<!-- Prompt 3: Security Scan -->
<g class="line11">
<text class="prompt" x="0" y="280">claude ▶</text>
<text class="command" x="70" y="280">Is this token safe? 0x0E09...8B1e on BSC</text>
</g>
<!-- Response 3 -->
<g class="line12">
<text class="info" x="0" y="305">🛡️ Running GoPlus security scan...</text>
</g>
<g class="line13">
<text class="response" x="0" y="330">✅ Token: CAKE (PancakeSwap)</text>
</g>
<g class="line14">
<text class="success" x="0" y="355"> Security Score: 95/100 - SAFE</text>
</g>
<g class="line15">
<text class="success" x="0" y="380"> ✓ No honeypot ✓ Verified contract ✓ Renounced ownership</text>
</g>
</g>
<!-- Blinking Cursor -->
<rect class="cursor line15" x="20" y="445" width="10" height="18" rx="2"/>
</svg>
```
### scripts/rebuild-binance-mcp-individual.sh
```bash
#!/bin/bash
set -e
# Rebuild Binance-MCP with individual commits for each file
# Each file gets a unique commit with emoji and description
REPO_DIR="/workspaces/universal-crypto-mcp/binance-mcp-server"
WORK_DIR="/tmp/binance-mcp-individual"
GITHUB_USER="nirholas"
REPO_NAME="Binance-MCP"
echo "🚀 Rebuilding Binance-MCP with individual file commits..."
# Clean and create work directory
rm -rf "$WORK_DIR"
mkdir -p "$WORK_DIR"
cd "$WORK_DIR"
# Initialize fresh repo
git init
git config user.email "[email protected]"
git config user.name "nirholas"
# Function to add a single file and commit
commit_file() {
local file="$1"
local message="$2"
if [ -e "$REPO_DIR/$file" ]; then
mkdir -p "$(dirname "$file")"
cp "$REPO_DIR/$file" "$file"
git add "$file"
git commit -m "$message" 2>/dev/null || true
fi
}
echo "📦 Creating individual commits for each file..."
# ═══════════════════════════════════════════════════════════════
# ROOT CONFIGURATION FILES
# ═══════════════════════════════════════════════════════════════
commit_file "package.json" "🎯 Initialize package.json with project metadata and dependencies"
commit_file "tsconfig.json" "⚙️ Configure TypeScript compiler options for strict type checking"
commit_file ".gitignore" "🙈 Define Git ignore patterns for node_modules and build artifacts"
commit_file "README.md" "📖 Add comprehensive documentation with setup and usage guide"
commit_file "binance-us-rest-api.md" "📚 Include complete Binance REST API reference documentation"
commit_file "config.json" "🔧 Add server configuration template with API settings"
# ═══════════════════════════════════════════════════════════════
# CORE SOURCE FILES
# ═══════════════════════════════════════════════════════════════
commit_file "src/index.ts" "🚀 Create main entry point with server initialization"
commit_file "src/binance.ts" "🔌 Implement Binance API client with HMAC authentication"
commit_file "src/init.ts" "⚡ Add module initialization and tool registration logic"
# ═══════════════════════════════════════════════════════════════
# CONFIG MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/config/binanceClient.ts" "🔐 Create Binance client configuration with API credentials"
commit_file "src/config/client.ts" "🌐 Add HTTP client wrapper for REST API calls"
# ═══════════════════════════════════════════════════════════════
# SERVER INFRASTRUCTURE
# ═══════════════════════════════════════════════════════════════
commit_file "src/server/base.ts" "🏗️ Implement MCP server base class with request handling"
commit_file "src/server/sse.ts" "📡 Add Server-Sent Events transport for real-time streaming"
commit_file "src/server/stdio.ts" "💻 Implement STDIO transport for CLI and editor integration"
# ═══════════════════════════════════════════════════════════════
# UTILITIES
# ═══════════════════════════════════════════════════════════════
commit_file "src/utils/logger.ts" "🛠️ Create structured logger with color-coded output levels"
# ═══════════════════════════════════════════════════════════════
# SPOT MODULE - General API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/spot/index.ts" "📈 Initialize spot trading module with all API exports"
commit_file "src/modules/spot/general-api/index.ts" "📋 Export all general API endpoints for spot trading"
commit_file "src/modules/spot/general-api/ping.ts" "🏓 Add ping endpoint to test API connectivity"
commit_file "src/modules/spot/general-api/time.ts" "⏰ Implement server time synchronization endpoint"
commit_file "src/modules/spot/general-api/exchangeInfo.ts" "🏛️ Add exchange info with trading rules and symbols"
# ═══════════════════════════════════════════════════════════════
# SPOT MODULE - Market API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/spot/market-api/index.ts" "📊 Export all market data API endpoints"
commit_file "src/modules/spot/market-api/depth.ts" "📉 Implement order book depth retrieval"
commit_file "src/modules/spot/market-api/getTrades.ts" "💹 Add recent trades list endpoint"
commit_file "src/modules/spot/market-api/historicalTrades.ts" "📜 Implement historical trades lookup"
commit_file "src/modules/spot/market-api/aggTrades.ts" "📦 Add compressed aggregate trades endpoint"
commit_file "src/modules/spot/market-api/klines.ts" "🕯️ Implement candlestick/kline data retrieval"
commit_file "src/modules/spot/market-api/uiKlines.ts" "📱 Add UI-optimized kline data endpoint"
commit_file "src/modules/spot/market-api/avgPrice.ts" "💰 Implement current average price calculation"
commit_file "src/modules/spot/market-api/ticker24hr.ts" "📈 Add 24-hour rolling window price statistics"
commit_file "src/modules/spot/market-api/ticker.ts" "🎯 Implement rolling window price change stats"
commit_file "src/modules/spot/market-api/tickerPrice.ts" "💵 Add symbol price ticker endpoint"
commit_file "src/modules/spot/market-api/tickerBookTicker.ts" "📕 Implement best bid/ask price endpoint"
commit_file "src/modules/spot/market-api/tickerTradingDay.ts" "📅 Add trading day price change statistics"
# ═══════════════════════════════════════════════════════════════
# SPOT MODULE - Trade API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/spot/trade-api/index.ts" "🔄 Export all spot trading order endpoints"
commit_file "src/modules/spot/trade-api/newOrder.ts" "✨ Implement new order placement with all order types"
commit_file "src/modules/spot/trade-api/getOrder.ts" "🔍 Add single order status query endpoint"
commit_file "src/modules/spot/trade-api/getOpenOrders.ts" "📋 Implement open orders list retrieval"
commit_file "src/modules/spot/trade-api/allOrders.ts" "📚 Add all orders history query endpoint"
commit_file "src/modules/spot/trade-api/deleteOrder.ts" "❌ Implement single order cancellation"
commit_file "src/modules/spot/trade-api/deleteOpenOrders.ts" "🗑️ Add batch cancel all open orders endpoint"
commit_file "src/modules/spot/trade-api/orderOco.ts" "⚖️ Implement OCO (One-Cancels-Other) order placement"
commit_file "src/modules/spot/trade-api/openOrderList.ts" "📝 Add open order list query endpoint"
# ═══════════════════════════════════════════════════════════════
# SPOT MODULE - Account API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/spot/account-api/index.ts" "👤 Export all account information endpoints"
commit_file "src/modules/spot/account-api/getAccount.ts" "💼 Implement account balance and info retrieval"
commit_file "src/modules/spot/account-api/myTrades.ts" "📊 Add personal trade history query endpoint"
commit_file "src/modules/spot/account-api/myAllocations.ts" "🎰 Implement SOR order allocation history"
commit_file "src/modules/spot/account-api/myPreventedMatches.ts" "🚫 Add self-trade prevention matches query"
commit_file "src/modules/spot/account-api/accountCommission.ts" "💸 Implement account commission rates query"
commit_file "src/modules/spot/account-api/rateLimitOrder.ts" "⏱️ Add order rate limit status endpoint"
# ═══════════════════════════════════════════════════════════════
# SPOT MODULE - User Data Stream API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/spot/userdatastream-api/index.ts" "📡 Export user data stream management endpoints"
commit_file "src/modules/spot/userdatastream-api/newUserDataStream.ts" "🔔 Implement listen key creation for WebSocket"
commit_file "src/modules/spot/userdatastream-api/putUserDataStream.ts" "🔄 Add listen key keepalive ping endpoint"
commit_file "src/modules/spot/userdatastream-api/deleteUserDataStream.ts" "🔕 Implement listen key close endpoint"
# ═══════════════════════════════════════════════════════════════
# MARGIN MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/margin/index.ts" "📊 Initialize margin trading module with leverage support"
# ═══════════════════════════════════════════════════════════════
# FUTURES MODULES
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/futures-usdm/index.ts" "🔮 Initialize USD-M futures module for perpetual contracts"
commit_file "src/modules/futures-coinm/index.ts" "🪙 Initialize COIN-M futures module for coin-margined contracts"
# ═══════════════════════════════════════════════════════════════
# OPTIONS MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/options/index.ts" "🎲 Initialize options trading module for derivatives"
# ═══════════════════════════════════════════════════════════════
# ALGO MODULE - Futures Algo
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/algo/index.ts" "🤖 Initialize algorithmic trading module"
commit_file "src/modules/algo/future-algo/index.ts" "📊 Export all futures algorithmic order endpoints"
commit_file "src/modules/algo/future-algo/TwapNewTrade.ts" "⏱️ Implement TWAP order placement for futures"
commit_file "src/modules/algo/future-algo/VPNewTrade.ts" "📈 Add Volume Participation order for futures"
commit_file "src/modules/algo/future-algo/cancelAlgoOrder.ts" "❌ Implement algo order cancellation"
commit_file "src/modules/algo/future-algo/currentAlgoOpenOrders.ts" "📋 Add current open algo orders query"
commit_file "src/modules/algo/future-algo/historicalAlgoOrder.ts" "📜 Implement historical algo orders retrieval"
commit_file "src/modules/algo/future-algo/subOrders.ts" "📦 Add sub-order details query for algo orders"
# ═══════════════════════════════════════════════════════════════
# ALGO MODULE - Spot Algo
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/algo/spot-algo/index.ts" "📊 Export all spot algorithmic order endpoints"
commit_file "src/modules/algo/spot-algo/spotTWAPOrder.ts" "⏱️ Implement TWAP order placement for spot"
commit_file "src/modules/algo/spot-algo/cancelOpenTWAPOrder.ts" "❌ Add TWAP order cancellation endpoint"
commit_file "src/modules/algo/spot-algo/currentAlgoOpenOrders.ts" "📋 Implement current spot algo orders query"
commit_file "src/modules/algo/spot-algo/historicalAlgoOrders.ts" "📜 Add historical spot algo orders retrieval"
commit_file "src/modules/algo/spot-algo/subOrders.ts" "📦 Implement sub-order query for spot algo"
# ═══════════════════════════════════════════════════════════════
# COPY TRADING MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/copy-trading/index.ts" "👥 Initialize copy trading module"
commit_file "src/modules/copy-trading/FutureCopyTrading-api/index.ts" "📊 Export futures copy trading endpoints"
commit_file "src/modules/copy-trading/FutureCopyTrading-api/getFuturesLeadTraderStatus.ts" "🏆 Implement lead trader status query"
commit_file "src/modules/copy-trading/FutureCopyTrading-api/getFuturesLeadTradingSymbolWhitelist.ts" "📝 Add trading symbol whitelist retrieval"
# ═══════════════════════════════════════════════════════════════
# STAKING MODULE - ETH Staking
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/staking/index.ts" "💰 Initialize staking module for ETH and SOL"
commit_file "src/modules/staking/ETH-staking-api/index.ts" "⟠ Export all ETH staking endpoints"
commit_file "src/modules/staking/ETH-staking-api/ethStakingAccount.ts" "💼 Implement ETH staking account query"
commit_file "src/modules/staking/ETH-staking-api/subscribeEthStaking.ts" "✅ Add ETH staking subscription endpoint"
commit_file "src/modules/staking/ETH-staking-api/redeemEth.ts" "💸 Implement ETH unstaking redemption"
commit_file "src/modules/staking/ETH-staking-api/getCurrentEthStakingQuota.ts" "📊 Add ETH staking quota query"
commit_file "src/modules/staking/ETH-staking-api/getEthStakingHistory.ts" "📜 Implement ETH staking history retrieval"
commit_file "src/modules/staking/ETH-staking-api/getEthRedemptionHistory.ts" "📋 Add ETH redemption history query"
commit_file "src/modules/staking/ETH-staking-api/wrapBeth.ts" "🔄 Implement BETH to WBETH wrapping"
commit_file "src/modules/staking/ETH-staking-api/getWbethWrapHistory.ts" "📜 Add WBETH wrap history query"
commit_file "src/modules/staking/ETH-staking-api/getWbethUnwrapHistory.ts" "📋 Implement WBETH unwrap history"
commit_file "src/modules/staking/ETH-staking-api/getWbethRewardsHistory.ts" "🎁 Add WBETH rewards history query"
commit_file "src/modules/staking/ETH-staking-api/getWbethRateHistory.ts" "📈 Implement WBETH exchange rate history"
# ═══════════════════════════════════════════════════════════════
# STAKING MODULE - SOL Staking
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/staking/SOL-staking-api/index.ts" "◎ Export all SOL staking endpoints"
commit_file "src/modules/staking/SOL-staking-api/solStakingAccount.ts" "💼 Implement SOL staking account query"
commit_file "src/modules/staking/SOL-staking-api/subscribeSolStaking.ts" "✅ Add SOL staking subscription endpoint"
commit_file "src/modules/staking/SOL-staking-api/redeemSol.ts" "💸 Implement SOL unstaking redemption"
commit_file "src/modules/staking/SOL-staking-api/getSolStakingQuotaDetails.ts" "📊 Add SOL staking quota details"
commit_file "src/modules/staking/SOL-staking-api/getSolStakingHistory.ts" "📜 Implement SOL staking history"
commit_file "src/modules/staking/SOL-staking-api/getSolRedemptionHistory.ts" "📋 Add SOL redemption history query"
commit_file "src/modules/staking/SOL-staking-api/getBnsolRateHistory.ts" "📈 Implement BNSOL exchange rate history"
commit_file "src/modules/staking/SOL-staking-api/getBnsolRewardsHistory.ts" "🎁 Add BNSOL rewards history query"
commit_file "src/modules/staking/SOL-staking-api/getUnclaimedRewards.ts" "💎 Implement unclaimed rewards query"
commit_file "src/modules/staking/SOL-staking-api/claimBoostRewards.ts" "🚀 Add boost rewards claim endpoint"
commit_file "src/modules/staking/SOL-staking-api/getBoostRewardsHistory.ts" "📜 Implement boost rewards history"
# ═══════════════════════════════════════════════════════════════
# SIMPLE EARN MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/simple-earn/index.ts" "🌾 Initialize simple earn module for flexible savings"
commit_file "src/modules/simple-earn/account-api/index.ts" "📊 Export simple earn account endpoints"
commit_file "src/modules/simple-earn/account-api/simpleEarnFlexibleProductList.ts" "📋 Implement flexible product listing"
commit_file "src/modules/simple-earn/account-api/getFlexibleProductPosition.ts" "💼 Add flexible product position query"
commit_file "src/modules/simple-earn/earn-api/index.ts" "💰 Export simple earn action endpoints"
commit_file "src/modules/simple-earn/earn-api/subscribeFlexibleProduct.ts" "✅ Implement flexible product subscription"
commit_file "src/modules/simple-earn/earn-api/redeemFlexibleProduct.ts" "💸 Add flexible product redemption"
# ═══════════════════════════════════════════════════════════════
# AUTO-INVEST MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/auto-invest/index.ts" "📈 Initialize auto-invest module for DCA strategies"
# ═══════════════════════════════════════════════════════════════
# DUAL INVESTMENT MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/dual-investment/index.ts" "🎰 Initialize dual investment module"
commit_file "src/modules/dual-investment/market-api/index.ts" "📊 Export dual investment market endpoints"
commit_file "src/modules/dual-investment/market-api/getDualInvestmentProductList.ts" "📋 Implement product list retrieval"
commit_file "src/modules/dual-investment/trade-api/index.ts" "💰 Export dual investment trade endpoints"
commit_file "src/modules/dual-investment/trade-api/subscribeDualInvestmentProducts.ts" "✅ Add product subscription endpoint"
commit_file "src/modules/dual-investment/trade-api/getDualInvestmentPositions.ts" "💼 Implement positions query"
commit_file "src/modules/dual-investment/trade-api/checkDualInvestmentAccounts.ts" "👤 Add account check endpoint"
commit_file "src/modules/dual-investment/trade-api/changeAutoCompoundStatus.ts" "🔄 Implement auto-compound toggle"
# ═══════════════════════════════════════════════════════════════
# VIP LOAN MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/vip-loan/index.ts" "🏦 Initialize VIP loan module for institutional lending"
commit_file "src/modules/vip-loan/market-api/index.ts" "📊 Export VIP loan market data endpoints"
commit_file "src/modules/vip-loan/market-api/getLoanableAssetsData.ts" "💰 Implement loanable assets query"
commit_file "src/modules/vip-loan/market-api/getCollateralAssetData.ts" "🔒 Add collateral assets data retrieval"
commit_file "src/modules/vip-loan/market-api/getBorrowInterestRate.ts" "📈 Implement borrow interest rate query"
commit_file "src/modules/vip-loan/trade-api/index.ts" "💳 Export VIP loan trading endpoints"
commit_file "src/modules/vip-loan/trade-api/vipLoanBorrow.ts" "💸 Implement VIP loan borrow action"
commit_file "src/modules/vip-loan/trade-api/vipLoanRepay.ts" "✅ Add VIP loan repayment endpoint"
commit_file "src/modules/vip-loan/trade-api/vipLoanRenew.ts" "🔄 Implement VIP loan renewal"
commit_file "src/modules/vip-loan/userInformation-api/index.ts" "👤 Export VIP loan user info endpoints"
commit_file "src/modules/vip-loan/userInformation-api/getVIPLoanOngoingOrders.ts" "📋 Implement ongoing orders query"
commit_file "src/modules/vip-loan/userInformation-api/checkVIPLoanCollateralAccount.ts" "🔒 Add collateral account check"
commit_file "src/modules/vip-loan/userInformation-api/queryApplicationStatus.ts" "📊 Implement application status query"
# ═══════════════════════════════════════════════════════════════
# CRYPTO LOANS MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/crypto-loans/index.ts" "💳 Initialize crypto loans module for collateral lending"
# ═══════════════════════════════════════════════════════════════
# FIAT MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/fiat/index.ts" "💵 Initialize fiat module for deposit and withdrawal"
commit_file "src/modules/fiat/fiat-api/getFiatDepositWithdrawHistory.ts" "📜 Implement fiat deposit/withdraw history"
commit_file "src/modules/fiat/fiat-api/getFiatPaymentsHistory.ts" "💳 Add fiat payments history query"
# ═══════════════════════════════════════════════════════════════
# PAY MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/pay/index.ts" "💸 Initialize Binance Pay module"
commit_file "src/modules/pay/pay-api/getPayTradeHistory.ts" "📜 Implement Pay trade history retrieval"
# ═══════════════════════════════════════════════════════════════
# CONVERT MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/convert/index.ts" "🔄 Initialize convert module for instant swaps"
commit_file "src/modules/convert/market-data-api/index.ts" "📊 Export convert market data endpoints"
commit_file "src/modules/convert/market-data-api/listAllConvertPairs.ts" "📋 Implement convert pairs listing"
commit_file "src/modules/convert/market-data-api/queryOrderQuantityPrecisionPerAsset.ts" "🎯 Add asset precision query"
commit_file "src/modules/convert/trade-api/index.ts" "💱 Export convert trading endpoints"
commit_file "src/modules/convert/trade-api/sendQuoteRequest.ts" "💬 Implement quote request endpoint"
commit_file "src/modules/convert/trade-api/acceptQuote.ts" "✅ Add quote acceptance endpoint"
commit_file "src/modules/convert/trade-api/orderStatus.ts" "🔍 Implement order status query"
commit_file "src/modules/convert/trade-api/placeLimitOrder.ts" "📝 Add limit order placement"
commit_file "src/modules/convert/trade-api/queryLimitOpenOrders.ts" "📋 Implement open limit orders query"
commit_file "src/modules/convert/trade-api/cancelLimitOrder.ts" "❌ Add limit order cancellation"
commit_file "src/modules/convert/trade-api/getConvertTradeHistory.ts" "📜 Implement convert history retrieval"
# ═══════════════════════════════════════════════════════════════
# C2C MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/c2c/index.ts" "👤 Initialize C2C peer-to-peer trading module"
commit_file "src/modules/c2c/C2C/getC2CTradeHistory.ts" "📜 Implement C2C trade history retrieval"
# ═══════════════════════════════════════════════════════════════
# WALLET MODULE - Account API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/wallet/index.ts" "👛 Initialize wallet module for balances and transfers"
commit_file "src/modules/wallet/account-api/index.ts" "👤 Export wallet account endpoints"
commit_file "src/modules/wallet/account-api/accountInfo.ts" "💼 Implement account information query"
commit_file "src/modules/wallet/account-api/accountStatus.ts" "🔍 Add account status retrieval"
commit_file "src/modules/wallet/account-api/accountApiTradingStatus.ts" "📊 Implement API trading status query"
commit_file "src/modules/wallet/account-api/dailyAccountSnapshot.ts" "📸 Add daily account snapshot retrieval"
commit_file "src/modules/wallet/account-api/getApiKeyPermission.ts" "🔑 Implement API key permissions query"
commit_file "src/modules/wallet/account-api/enableFastWithdrawSwitch.ts" "⚡ Add fast withdraw enable endpoint"
commit_file "src/modules/wallet/account-api/disableFastWithdrawSwitch.ts" "🐢 Implement fast withdraw disable"
# ═══════════════════════════════════════════════════════════════
# WALLET MODULE - Asset API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/wallet/asset-api/index.ts" "💰 Export wallet asset management endpoints"
commit_file "src/modules/wallet/asset-api/userAsset.ts" "💼 Implement user asset balances query"
commit_file "src/modules/wallet/asset-api/fundingWallet.ts" "🏦 Add funding wallet balance retrieval"
commit_file "src/modules/wallet/asset-api/assetDetail.ts" "📋 Implement asset detail information"
commit_file "src/modules/wallet/asset-api/assetDividendRecord.ts" "🎁 Add asset dividend records query"
commit_file "src/modules/wallet/asset-api/tradeFee.ts" "💸 Implement trade fee query endpoint"
commit_file "src/modules/wallet/asset-api/dustlog.ts" "🧹 Add dust conversion history"
commit_file "src/modules/wallet/asset-api/dustTransfer.ts" "🔄 Implement small balance to BNB conversion"
commit_file "src/modules/wallet/asset-api/getAssetsThatCanBeConvertedIntoBnb.ts" "📋 Add convertible assets list"
commit_file "src/modules/wallet/asset-api/userUniversalTransfer.ts" "🔄 Implement universal asset transfer"
commit_file "src/modules/wallet/asset-api/queryUserUniversalTransferHistory.ts" "📜 Add transfer history query"
commit_file "src/modules/wallet/asset-api/queryUserWalletBalance.ts" "💰 Implement wallet balance query"
commit_file "src/modules/wallet/asset-api/queryUserDelegationHistory.ts" "📋 Add delegation history retrieval"
commit_file "src/modules/wallet/asset-api/toggleBnbBurnOnSpotTradeAndMarginInterest.ts" "🔥 Implement BNB burn toggle"
commit_file "src/modules/wallet/asset-api/getCloudMiningPaymentAndRefundHistory.ts" "⛏️ Add cloud mining history"
commit_file "src/modules/wallet/asset-api/getOpenSymbolList.ts" "📋 Implement open symbols listing"
# ═══════════════════════════════════════════════════════════════
# WALLET MODULE - Capital API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/wallet/capital-api/index.ts" "💳 Export capital management endpoints"
commit_file "src/modules/wallet/capital-api/allCoinsInformation.ts" "🪙 Implement all coins info retrieval"
commit_file "src/modules/wallet/capital-api/depositAddress.ts" "📥 Add deposit address generation"
commit_file "src/modules/wallet/capital-api/fetchDepositAddressListWithNetwork.ts" "📋 Implement network deposit addresses"
commit_file "src/modules/wallet/capital-api/depositHistory.ts" "📜 Add deposit history query"
commit_file "src/modules/wallet/capital-api/withdraw.ts" "📤 Implement cryptocurrency withdrawal"
commit_file "src/modules/wallet/capital-api/withdrawHistory.ts" "📜 Add withdrawal history query"
commit_file "src/modules/wallet/capital-api/fetchWithdrawAddressList.ts" "📋 Implement withdraw address list"
commit_file "src/modules/wallet/capital-api/oneClickArrivalDepositApply.ts" "⚡ Add instant deposit application"
# ═══════════════════════════════════════════════════════════════
# WALLET MODULE - Others API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/wallet/others-api/index.ts" "📊 Export miscellaneous wallet endpoints"
commit_file "src/modules/wallet/others-api/systemStatus.ts" "🔧 Implement system status check"
commit_file "src/modules/wallet/others-api/getSymbolsDelistScheduleForSpot.ts" "📅 Add delist schedule query"
# ═══════════════════════════════════════════════════════════════
# WALLET MODULE - Travel Rule API
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/wallet/travel-rule-api/index.ts" "✈️ Export travel rule compliance endpoints"
commit_file "src/modules/wallet/travel-rule-api/withdrawTravelRule.ts" "📤 Implement travel rule withdraw"
commit_file "src/modules/wallet/travel-rule-api/withdrawHistoryV1.ts" "📜 Add withdraw history v1 query"
commit_file "src/modules/wallet/travel-rule-api/withdrawHistoryV2.ts" "📜 Implement withdraw history v2"
commit_file "src/modules/wallet/travel-rule-api/depositHistoryTravelRule.ts" "📥 Add travel rule deposit history"
commit_file "src/modules/wallet/travel-rule-api/submitDepositQuestionnaire.ts" "📝 Implement deposit questionnaire"
commit_file "src/modules/wallet/travel-rule-api/submitDepositQuestionnaireTravelRule.ts" "✅ Add travel rule questionnaire"
commit_file "src/modules/wallet/travel-rule-api/onboardedVaspList.ts" "📋 Implement onboarded VASP listing"
commit_file "src/modules/wallet/travel-rule-api/brokerWithdraw.ts" "🏦 Add broker withdrawal endpoint"
# ═══════════════════════════════════════════════════════════════
# PORTFOLIO MARGIN MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/portfolio-margin/index.ts" "📊 Initialize portfolio margin module for unified margin"
# ═══════════════════════════════════════════════════════════════
# REBATE MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/rebate/index.ts" "🎁 Initialize rebate module for commission tracking"
commit_file "src/modules/rebate/rebate-api/getSpotRebateHistoryRecords.ts" "📜 Implement spot rebate history query"
# ═══════════════════════════════════════════════════════════════
# NFT MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/nft/index.ts" "🖼️ Initialize NFT module for digital collectibles"
commit_file "src/modules/nft/nft-api/getNFTAsset.ts" "🎨 Implement NFT asset retrieval"
commit_file "src/modules/nft/nft-api/getNFTTransactionHistory.ts" "📜 Add NFT transaction history query"
commit_file "src/modules/nft/nft-api/getNFTDepositHistory.ts" "📥 Implement NFT deposit history"
commit_file "src/modules/nft/nft-api/getNFTWithdrawHistory.ts" "📤 Add NFT withdrawal history query"
# ═══════════════════════════════════════════════════════════════
# GIFT CARD MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/gift-card/index.ts" "🎀 Initialize gift card module for crypto gifts"
# ═══════════════════════════════════════════════════════════════
# MINING MODULE
# ═══════════════════════════════════════════════════════════════
commit_file "src/modules/mining/index.ts" "⛏️ Initialize mining module for pool statistics"
commit_file "src/modules/mining/mining-api/acquiringAlgorithm.ts" "🔧 Implement mining algorithm query"
commit_file "src/modules/mining/mining-api/acquiringCoinname.ts" "🪙 Add mineable coin names retrieval"
commit_file "src/modules/mining/mining-api/requestForMinerList.ts" "👷 Implement miner list query"
commit_file "src/modules/mining/mining-api/requestForDetailMinerList.ts" "📋 Add detailed miner information"
commit_file "src/modules/mining/mining-api/accountList.ts" "💼 Implement mining account listing"
commit_file "src/modules/mining/mining-api/statisticList.ts" "📊 Add mining statistics retrieval"
commit_file "src/modules/mining/mining-api/earningsList.ts" "💰 Implement mining earnings query"
commit_file "src/modules/mining/mining-api/extraBonusList.ts" "🎁 Add extra bonus list retrieval"
commit_file "src/modules/mining/mining-api/miningAccountEarning.ts" "📈 Implement account earning details"
commit_file "src/modules/mining/mining-api/hashrateResaleList.ts" "📋 Add hashrate resale listing"
commit_file "src/modules/mining/mining-api/hashrateResaleDetail.ts" "📊 Implement resale detail query"
commit_file "src/modules/mining/mining-api/hashrateResaleRequest.ts" "📝 Add hashrate resale request"
commit_file "src/modules/mining/mining-api/cancelHashrateResaleConfiguration.ts" "🚫 Cancel hashrate resale agreements for mining pools"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Root Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binanceAccountInfo.ts" "👤 Add MCP tool for account information retrieval"
commit_file "src/tools/binanceOrderBook.ts" "📕 Implement MCP tool for order book depth"
commit_file "src/tools/binanceSpotPlaceOrder.ts" "✨ Add MCP tool for spot order placement"
commit_file "src/tools/binanceTimeWeightedAveragePriceFutureAlgo.ts" "⏱️ Implement MCP tool for TWAP futures"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Spot Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-spot/index.ts" "📈 Export all spot trading MCP tools"
commit_file "src/tools/binance-spot/general-api/index.ts" "📋 Export spot general API tools"
commit_file "src/tools/binance-spot/general-api/ping.ts" "🏓 Add MCP tool for API ping test"
commit_file "src/tools/binance-spot/general-api/time.ts" "⏰ Implement MCP tool for server time"
commit_file "src/tools/binance-spot/general-api/exchangeInfo.ts" "🏛️ Add MCP tool for exchange information"
commit_file "src/tools/binance-spot/market-api/index.ts" "📊 Export spot market data tools"
commit_file "src/tools/binance-spot/market-api/depth.ts" "📉 Implement MCP tool for order book depth"
commit_file "src/tools/binance-spot/market-api/getTrades.ts" "💹 Add MCP tool for recent trades"
commit_file "src/tools/binance-spot/market-api/historicalTrades.ts" "📜 Implement MCP tool for historical trades"
commit_file "src/tools/binance-spot/market-api/aggTrades.ts" "📦 Add MCP tool for aggregate trades"
commit_file "src/tools/binance-spot/market-api/klines.ts" "🕯️ Implement MCP tool for candlestick data"
commit_file "src/tools/binance-spot/market-api/uiKlines.ts" "📱 Add MCP tool for UI klines"
commit_file "src/tools/binance-spot/market-api/avgPrice.ts" "💰 Implement MCP tool for average price"
commit_file "src/tools/binance-spot/market-api/ticker24hr.ts" "📈 Add MCP tool for 24hr ticker"
commit_file "src/tools/binance-spot/market-api/ticker.ts" "🎯 Implement MCP tool for rolling ticker"
commit_file "src/tools/binance-spot/market-api/tickerPrice.ts" "💵 Add MCP tool for price ticker"
commit_file "src/tools/binance-spot/market-api/tickerBookTicker.ts" "📕 Implement MCP tool for book ticker"
commit_file "src/tools/binance-spot/market-api/tickerTradingDay.ts" "📅 Add MCP tool for trading day stats"
commit_file "src/tools/binance-spot/trade-api/index.ts" "🔄 Export spot trading tools"
commit_file "src/tools/binance-spot/trade-api/newOrder.ts" "✨ Implement MCP tool for new orders"
commit_file "src/tools/binance-spot/trade-api/getOrder.ts" "🔍 Add MCP tool for order query"
commit_file "src/tools/binance-spot/trade-api/getOpenOrders.ts" "📋 Implement MCP tool for open orders"
commit_file "src/tools/binance-spot/trade-api/allOrders.ts" "📚 Add MCP tool for all orders history"
commit_file "src/tools/binance-spot/trade-api/deleteOrder.ts" "❌ Implement MCP tool for order cancel"
commit_file "src/tools/binance-spot/trade-api/deleteOpenOrders.ts" "🗑️ Add MCP tool for batch cancel"
commit_file "src/tools/binance-spot/trade-api/orderOco.ts" "⚖️ Implement MCP tool for OCO orders"
commit_file "src/tools/binance-spot/trade-api/openOrderList.ts" "📝 Add MCP tool for order list query"
commit_file "src/tools/binance-spot/account-api/index.ts" "👤 Export spot account tools"
commit_file "src/tools/binance-spot/account-api/getAccount.ts" "💼 Implement MCP tool for account info"
commit_file "src/tools/binance-spot/account-api/myTrades.ts" "📊 Add MCP tool for trade history"
commit_file "src/tools/binance-spot/account-api/myAllocations.ts" "🎰 Implement MCP tool for allocations"
commit_file "src/tools/binance-spot/account-api/myPreventedMatches.ts" "🚫 Add MCP tool for prevented matches"
commit_file "src/tools/binance-spot/account-api/accountCommission.ts" "💸 Implement MCP tool for commissions"
commit_file "src/tools/binance-spot/account-api/rateLimitOrder.ts" "⏱️ Add MCP tool for rate limits"
commit_file "src/tools/binance-spot/userdatastream-api/index.ts" "📡 Export user data stream tools"
commit_file "src/tools/binance-spot/userdatastream-api/newUserDataStream.ts" "🔔 Implement MCP tool for listen key"
commit_file "src/tools/binance-spot/userdatastream-api/putUserDataStream.ts" "🔄 Add MCP tool for keepalive"
commit_file "src/tools/binance-spot/userdatastream-api/deleteUserDataStream.ts" "🔕 Implement MCP tool for close stream"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Margin Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-margin/index.ts" "📊 Export all margin trading MCP tools"
commit_file "src/tools/binance-margin/cross-margin-api/index.ts" "📋 Export cross margin API tools"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginAccount.ts" "💼 Implement MCP tool for margin account"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginBorrow.ts" "💸 Add MCP tool for margin borrow"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginRepay.ts" "✅ Implement MCP tool for margin repay"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginTransfer.ts" "🔄 Add MCP tool for margin transfer"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginMaxBorrowable.ts" "📊 Implement MCP tool for max borrow"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginMaxTransferable.ts" "📈 Add MCP tool for max transfer"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginLoanRecord.ts" "📜 Implement MCP tool for loan records"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginRepayRecord.ts" "📋 Add MCP tool for repay records"
commit_file "src/tools/binance-margin/cross-margin-api/crossMarginInterestHistory.ts" "📈 Implement MCP tool for interest history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Algo Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-algo/index.ts" "🤖 Export all algo trading MCP tools"
commit_file "src/tools/binance-algo/future-algo/index.ts" "📊 Export futures algo tools"
commit_file "src/tools/binance-algo/future-algo/TwapNewTrade.ts" "⏱️ Implement MCP tool for futures TWAP"
commit_file "src/tools/binance-algo/future-algo/VPNewTrade.ts" "📈 Add MCP tool for futures VP"
commit_file "src/tools/binance-algo/future-algo/cancelAlgoOrder.ts" "❌ Implement MCP tool for algo cancel"
commit_file "src/tools/binance-algo/future-algo/currentAlgoOpenOrders.ts" "📋 Add MCP tool for algo open orders"
commit_file "src/tools/binance-algo/future-algo/historicalAlgoOrder.ts" "📜 Implement MCP tool for algo history"
commit_file "src/tools/binance-algo/future-algo/subOrders.ts" "📦 Add MCP tool for algo sub-orders"
commit_file "src/tools/binance-algo/spot-algo/index.ts" "📊 Export spot algo tools"
commit_file "src/tools/binance-algo/spot-algo/spotTWAPOrder.ts" "⏱️ Implement MCP tool for spot TWAP"
commit_file "src/tools/binance-algo/spot-algo/cancelOpenTWAPOrder.ts" "❌ Add MCP tool for TWAP cancel"
commit_file "src/tools/binance-algo/spot-algo/currentAlgoOpenOrders.ts" "📋 Implement MCP tool for spot algo orders"
commit_file "src/tools/binance-algo/spot-algo/historicalAlgoOrders.ts" "📜 Add MCP tool for spot algo history"
commit_file "src/tools/binance-algo/spot-algo/subOrders.ts" "📦 Implement MCP tool for spot sub-orders"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Copy Trading Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-copy-trading/index.ts" "👥 Export all copy trading MCP tools"
commit_file "src/tools/binance-copy-trading/FutureCopyTrading-api/index.ts" "📊 Export futures copy trading tools"
commit_file "src/tools/binance-copy-trading/FutureCopyTrading-api/getFuturesLeadTraderStatus.ts" "🏆 Implement MCP tool for lead status"
commit_file "src/tools/binance-copy-trading/FutureCopyTrading-api/getFuturesLeadTradingSymbolWhitelist.ts" "📝 Add MCP tool for symbol whitelist"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Staking Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-staking/index.ts" "💰 Export all staking MCP tools"
commit_file "src/tools/binance-staking/ETH-staking-api/index.ts" "⟠ Export ETH staking tools"
commit_file "src/tools/binance-staking/ETH-staking-api/ethStakingAccount.ts" "💼 Implement MCP tool for ETH account"
commit_file "src/tools/binance-staking/ETH-staking-api/subscribeEthStaking.ts" "✅ Add MCP tool for ETH stake"
commit_file "src/tools/binance-staking/ETH-staking-api/redeemEth.ts" "💸 Implement MCP tool for ETH redeem"
commit_file "src/tools/binance-staking/ETH-staking-api/getCurrentEthStakingQuota.ts" "📊 Add MCP tool for ETH quota"
commit_file "src/tools/binance-staking/ETH-staking-api/getEthStakingHistory.ts" "📜 Implement MCP tool for stake history"
commit_file "src/tools/binance-staking/ETH-staking-api/getEthRedemptionHistory.ts" "📋 Add MCP tool for redemption history"
commit_file "src/tools/binance-staking/ETH-staking-api/wrapBeth.ts" "🔄 Implement MCP tool for BETH wrap"
commit_file "src/tools/binance-staking/ETH-staking-api/getWbethWrapHistory.ts" "📜 Add MCP tool for wrap history"
commit_file "src/tools/binance-staking/ETH-staking-api/getWbethUnwrapHistory.ts" "📋 Implement MCP tool for unwrap history"
commit_file "src/tools/binance-staking/ETH-staking-api/getWbethRewardsHistory.ts" "🎁 Add MCP tool for WBETH rewards"
commit_file "src/tools/binance-staking/ETH-staking-api/getWbethRateHistory.ts" "📈 Implement MCP tool for rate history"
commit_file "src/tools/binance-staking/SOL-staking-api/index.ts" "◎ Export SOL staking tools"
commit_file "src/tools/binance-staking/SOL-staking-api/solStakingAccount.ts" "💼 Implement MCP tool for SOL account"
commit_file "src/tools/binance-staking/SOL-staking-api/subscribeSolStaking.ts" "✅ Add MCP tool for SOL stake"
commit_file "src/tools/binance-staking/SOL-staking-api/redeemSol.ts" "💸 Implement MCP tool for SOL redeem"
commit_file "src/tools/binance-staking/SOL-staking-api/getSolStakingQuotaDetails.ts" "📊 Add MCP tool for SOL quota"
commit_file "src/tools/binance-staking/SOL-staking-api/getSolStakingHistory.ts" "📜 Implement MCP tool for SOL history"
commit_file "src/tools/binance-staking/SOL-staking-api/getSolRedemptionHistory.ts" "📋 Add MCP tool for SOL redemption"
commit_file "src/tools/binance-staking/SOL-staking-api/getBnsolRateHistory.ts" "📈 Implement MCP tool for BNSOL rate"
commit_file "src/tools/binance-staking/SOL-staking-api/getBnsolRewardsHistory.ts" "🎁 Add MCP tool for BNSOL rewards"
commit_file "src/tools/binance-staking/SOL-staking-api/getUnclaimedRewards.ts" "💎 Implement MCP tool for unclaimed"
commit_file "src/tools/binance-staking/SOL-staking-api/claimBoostRewards.ts" "🚀 Add MCP tool for claim boost"
commit_file "src/tools/binance-staking/SOL-staking-api/getBoostRewardsHistory.ts" "📜 Implement MCP tool for boost history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Simple Earn Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-simple-earn/index.ts" "🌾 Export all simple earn MCP tools"
commit_file "src/tools/binance-simple-earn/account-api/index.ts" "📊 Export simple earn account tools"
commit_file "src/tools/binance-simple-earn/account-api/simpleEarnFlexibleProductList.ts" "📋 Implement MCP tool for products"
commit_file "src/tools/binance-simple-earn/account-api/getFlexibleProductPosition.ts" "💼 Add MCP tool for positions"
commit_file "src/tools/binance-simple-earn/earn-api/index.ts" "💰 Export simple earn action tools"
commit_file "src/tools/binance-simple-earn/earn-api/subscribeFlexibleProduct.ts" "✅ Implement MCP tool for subscribe"
commit_file "src/tools/binance-simple-earn/earn-api/redeemFlexibleProduct.ts" "💸 Add MCP tool for redeem"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Dual Investment Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-dual-investment/index.ts" "🎰 Export all dual investment MCP tools"
commit_file "src/tools/binance-dual-investment/market-api/index.ts" "📊 Export dual investment market tools"
commit_file "src/tools/binance-dual-investment/market-api/getDualInvestmentProductList.ts" "📋 Implement MCP tool for products"
commit_file "src/tools/binance-dual-investment/trade-api/index.ts" "💰 Export dual investment trade tools"
commit_file "src/tools/binance-dual-investment/trade-api/subscribeDualInvestmentProducts.ts" "✅ Add MCP tool for subscribe"
commit_file "src/tools/binance-dual-investment/trade-api/getDualInvestmentPositions.ts" "💼 Implement MCP tool for positions"
commit_file "src/tools/binance-dual-investment/trade-api/checkDualInvestmentAccounts.ts" "👤 Add MCP tool for account check"
commit_file "src/tools/binance-dual-investment/trade-api/changeAutoCompoundStatus.ts" "🔄 Implement MCP tool for auto-compound"
# ═══════════════════════════════════════════════════════════════
# TOOLS - VIP Loan Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-vip-loan/index.ts" "🏦 Export all VIP loan MCP tools"
commit_file "src/tools/binance-vip-loan/market-api/index.ts" "📊 Export VIP loan market tools"
commit_file "src/tools/binance-vip-loan/market-api/getLoanableAssetsData.ts" "💰 Implement MCP tool for loanable assets"
commit_file "src/tools/binance-vip-loan/market-api/getCollateralAssetData.ts" "🔒 Add MCP tool for collateral data"
commit_file "src/tools/binance-vip-loan/market-api/getBorrowInterestRate.ts" "📈 Implement MCP tool for interest rates"
commit_file "src/tools/binance-vip-loan/trade-api/index.ts" "💳 Export VIP loan trade tools"
commit_file "src/tools/binance-vip-loan/trade-api/vipLoanBorrow.ts" "💸 Add MCP tool for borrow"
commit_file "src/tools/binance-vip-loan/trade-api/vipLoanRepay.ts" "✅ Implement MCP tool for repay"
commit_file "src/tools/binance-vip-loan/trade-api/vipLoanRenew.ts" "🔄 Add MCP tool for loan renewal"
commit_file "src/tools/binance-vip-loan/userInformation-api/index.ts" "👤 Export VIP loan user info tools"
commit_file "src/tools/binance-vip-loan/userInformation-api/getVIPLoanOngoingOrders.ts" "📋 Implement MCP tool for ongoing orders"
commit_file "src/tools/binance-vip-loan/userInformation-api/checkVIPLoanCollateralAccount.ts" "🔒 Add MCP tool for collateral check"
commit_file "src/tools/binance-vip-loan/userInformation-api/queryApplicationStatus.ts" "📊 Implement MCP tool for app status"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Fiat Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-fiat/index.ts" "💵 Export all fiat MCP tools"
commit_file "src/tools/binance-fiat/fiat-api/getFiatDepositWithdrawHistory.ts" "📜 Implement MCP tool for fiat history"
commit_file "src/tools/binance-fiat/fiat-api/getFiatPaymentsHistory.ts" "💳 Add MCP tool for payment history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Pay Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-pay/index.ts" "💸 Export all Binance Pay MCP tools"
commit_file "src/tools/binance-pay/pay-api/getPayTradeHistory.ts" "📜 Implement MCP tool for Pay history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Convert Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-convert/index.ts" "🔄 Export all convert MCP tools"
commit_file "src/tools/binance-convert/market-data-api/index.ts" "📊 Export convert market tools"
commit_file "src/tools/binance-convert/market-data-api/listAllConvertPairs.ts" "📋 Implement MCP tool for pairs"
commit_file "src/tools/binance-convert/market-data-api/queryOrderQuantityPrecisionPerAsset.ts" "🎯 Add MCP tool for precision"
commit_file "src/tools/binance-convert/trade-api/index.ts" "💱 Export convert trade tools"
commit_file "src/tools/binance-convert/trade-api/sendQuoteRequest.ts" "💬 Implement MCP tool for quote"
commit_file "src/tools/binance-convert/trade-api/acceptQuote.ts" "✅ Add MCP tool for accept quote"
commit_file "src/tools/binance-convert/trade-api/orderStatus.ts" "🔍 Implement MCP tool for order status"
commit_file "src/tools/binance-convert/trade-api/placeLimitOrder.ts" "📝 Add MCP tool for limit order"
commit_file "src/tools/binance-convert/trade-api/queryLimitOpenOrders.ts" "📋 Implement MCP tool for open orders"
commit_file "src/tools/binance-convert/trade-api/cancelLimitOrder.ts" "❌ Add MCP tool for cancel limit"
commit_file "src/tools/binance-convert/trade-api/getConvertTradeHistory.ts" "📜 Implement MCP tool for convert history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - C2C Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-c2c/index.ts" "👤 Export all C2C MCP tools"
commit_file "src/tools/binance-c2c/C2C/getC2CTradeHistory.ts" "📜 Implement MCP tool for C2C history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Wallet Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-wallet/index.ts" "👛 Export all wallet MCP tools"
commit_file "src/tools/binance-wallet/account-api/index.ts" "👤 Export wallet account tools"
commit_file "src/tools/binance-wallet/account-api/accountInfo.ts" "💼 Implement MCP tool for account info"
commit_file "src/tools/binance-wallet/account-api/accountStatus.ts" "🔍 Add MCP tool for account status"
commit_file "src/tools/binance-wallet/account-api/accountApiTradingStatus.ts" "📊 Implement MCP tool for trading status"
commit_file "src/tools/binance-wallet/account-api/dailyAccountSnapshot.ts" "📸 Add MCP tool for daily snapshot"
commit_file "src/tools/binance-wallet/account-api/getApiKeyPermission.ts" "🔑 Implement MCP tool for API permissions"
commit_file "src/tools/binance-wallet/account-api/enableFastWithdrawSwitch.ts" "⚡ Add MCP tool for enable fast withdraw"
commit_file "src/tools/binance-wallet/account-api/disableFastWithdrawSwitch.ts" "🐢 Implement MCP tool for disable fast"
commit_file "src/tools/binance-wallet/asset-api/index.ts" "💰 Export wallet asset tools"
commit_file "src/tools/binance-wallet/asset-api/userAsset.ts" "💼 Implement MCP tool for user assets"
commit_file "src/tools/binance-wallet/asset-api/fundingWallet.ts" "🏦 Add MCP tool for funding wallet"
commit_file "src/tools/binance-wallet/asset-api/assetDetail.ts" "📋 Implement MCP tool for asset detail"
commit_file "src/tools/binance-wallet/asset-api/assetDividendRecord.ts" "🎁 Add MCP tool for dividends"
commit_file "src/tools/binance-wallet/asset-api/tradeFee.ts" "💸 Implement MCP tool for trade fees"
commit_file "src/tools/binance-wallet/asset-api/dustlog.ts" "🧹 Add MCP tool for dust log"
commit_file "src/tools/binance-wallet/asset-api/dustTransfer.ts" "🔄 Implement MCP tool for dust transfer"
commit_file "src/tools/binance-wallet/asset-api/getAssetsThatCanBeConvertedIntoBnb.ts" "📋 Add MCP tool for convertible assets"
commit_file "src/tools/binance-wallet/asset-api/userUniversalTransfer.ts" "🔄 Implement MCP tool for transfers"
commit_file "src/tools/binance-wallet/asset-api/queryUserUniversalTransferHistory.ts" "📜 Add MCP tool for transfer history"
commit_file "src/tools/binance-wallet/asset-api/queryUserWalletBalance.ts" "💰 Implement MCP tool for balance"
commit_file "src/tools/binance-wallet/asset-api/queryUserDelegationHistory.ts" "📋 Add MCP tool for delegation history"
commit_file "src/tools/binance-wallet/asset-api/toggleBnbBurnOnSpotTradeAndMarginInterest.ts" "🔥 Implement MCP tool for BNB burn"
commit_file "src/tools/binance-wallet/asset-api/getCloudMiningPaymentAndRefundHistory.ts" "⛏️ Add MCP tool for mining history"
commit_file "src/tools/binance-wallet/asset-api/getOpenSymbolList.ts" "📋 Implement MCP tool for open symbols"
commit_file "src/tools/binance-wallet/capital-api/index.ts" "💳 Export capital management tools"
commit_file "src/tools/binance-wallet/capital-api/allCoinsInformation.ts" "🪙 Implement MCP tool for coins info"
commit_file "src/tools/binance-wallet/capital-api/depositAddress.ts" "📥 Add MCP tool for deposit address"
commit_file "src/tools/binance-wallet/capital-api/fetchDepositAddressListWithNetwork.ts" "📋 Implement MCP tool for network addresses"
commit_file "src/tools/binance-wallet/capital-api/depositHistory.ts" "📜 Add MCP tool for deposit history"
commit_file "src/tools/binance-wallet/capital-api/withdraw.ts" "📤 Implement MCP tool for withdraw"
commit_file "src/tools/binance-wallet/capital-api/withdrawHistory.ts" "📜 Add MCP tool for withdraw history"
commit_file "src/tools/binance-wallet/capital-api/fetchWithdrawAddressList.ts" "📋 Implement MCP tool for address list"
commit_file "src/tools/binance-wallet/capital-api/oneClickArrivalDepositApply.ts" "⚡ Add MCP tool for instant deposit"
commit_file "src/tools/binance-wallet/others-api/index.ts" "📊 Export miscellaneous wallet tools"
commit_file "src/tools/binance-wallet/others-api/systemStatus.ts" "🔧 Implement MCP tool for system status"
commit_file "src/tools/binance-wallet/others-api/getSymbolsDelistScheduleForSpot.ts" "📅 Add MCP tool for delist schedule"
commit_file "src/tools/binance-wallet/travel-rule-api/index.ts" "✈️ Export travel rule tools"
commit_file "src/tools/binance-wallet/travel-rule-api/withdrawTravelRule.ts" "📤 Implement MCP tool for travel withdraw"
commit_file "src/tools/binance-wallet/travel-rule-api/withdrawHistoryV1.ts" "📜 Add MCP tool for history v1"
commit_file "src/tools/binance-wallet/travel-rule-api/withdrawHistoryV2.ts" "📜 Implement MCP tool for history v2"
commit_file "src/tools/binance-wallet/travel-rule-api/depositHistoryTravelRule.ts" "📥 Add MCP tool for deposit history"
commit_file "src/tools/binance-wallet/travel-rule-api/submitDepositQuestionnaire.ts" "📝 Implement MCP tool for questionnaire"
commit_file "src/tools/binance-wallet/travel-rule-api/submitDepositQuestionnaireTravelRule.ts" "✅ Add MCP tool for travel questionnaire"
commit_file "src/tools/binance-wallet/travel-rule-api/onboardedVaspList.ts" "📋 Implement MCP tool for VASP list"
commit_file "src/tools/binance-wallet/travel-rule-api/brokerWithdraw.ts" "🏦 Add MCP tool for broker withdraw"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Rebate Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-rebate/index.ts" "🎁 Export all rebate MCP tools"
commit_file "src/tools/binance-rebate/rebate-api/getSpotRebateHistoryRecords.ts" "📜 Implement MCP tool for rebate history"
# ═══════════════════════════════════════════════════════════════
# TOOLS - NFT Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-nft/index.ts" "🖼️ Export all NFT MCP tools"
commit_file "src/tools/binance-nft/nft-api/getNFTAsset.ts" "🎨 Implement MCP tool for NFT assets"
commit_file "src/tools/binance-nft/nft-api/getNFTTransactionHistory.ts" "📜 Add MCP tool for NFT transactions"
commit_file "src/tools/binance-nft/nft-api/getNFTDepositHistory.ts" "📥 Implement MCP tool for NFT deposits"
commit_file "src/tools/binance-nft/nft-api/getNFTWithdrawHistory.ts" "📤 Add MCP tool for NFT withdrawals"
# ═══════════════════════════════════════════════════════════════
# TOOLS - Mining Tools
# ═══════════════════════════════════════════════════════════════
commit_file "src/tools/binance-mining/index.ts" "⛏️ Export all mining MCP tools"
commit_file "src/tools/binance-mining/mining-api/acquiringAlgorithm.ts" "🔧 Implement MCP tool for algorithm query"
commit_file "src/tools/binance-mining/mining-api/acquiringCoinname.ts" "🪙 Add MCP tool for coin names"
commit_file "src/tools/binance-mining/mining-api/requestForMinerList.ts" "👷 Implement MCP tool for miner list"
commit_file "src/tools/binance-mining/mining-api/requestForDetailMinerList.ts" "📋 Add MCP tool for miner details"
commit_file "src/tools/binance-mining/mining-api/accountList.ts" "💼 Implement MCP tool for mining accounts"
commit_file "src/tools/binance-mining/mining-api/statisticList.ts" "📊 Add MCP tool for mining stats"
commit_file "src/tools/binance-mining/mining-api/earningsList.ts" "💰 Implement MCP tool for earnings"
commit_file "src/tools/binance-mining/mining-api/extraBonusList.ts" "🎁 Add MCP tool for extra bonus"
commit_file "src/tools/binance-mining/mining-api/miningAccountEarning.ts" "📈 Implement MCP tool for account earnings"
commit_file "src/tools/binance-mining/mining-api/hashrateResaleList.ts" "📋 Add MCP tool for resale list"
commit_file "src/tools/binance-mining/mining-api/hashrateResaleDetail.ts" "📊 Implement MCP tool for resale details"
commit_file "src/tools/binance-mining/mining-api/hashrateResaleRequest.ts" "📝 Add MCP tool for resale request"
commit_file "src/tools/binance-mining/mining-api/cancelHashrateResaleConfiguration.ts" "⛏️ Add hashrate resale cancellation for mining pool management"
echo ""
echo "✅ All individual commits created!"
echo ""
COMMIT_COUNT=$(git log --oneline | wc -l)
echo "📊 Total commits: $COMMIT_COUNT"
echo ""
echo "📋 First 20 commits:"
git log --oneline | tail -20
echo ""
echo "📋 Last 20 commits:"
git log --oneline | head -20
echo ""
echo "🚀 Ready to push!"
```
### scripts/rebuild-binance-mcp.sh
```bash
#!/bin/bash
set -e
# Rebuild Binance-MCP with curated commit history
# Each logical group gets a unique commit with emoji
REPO_DIR="/workspaces/universal-crypto-mcp/binance-mcp-server"
WORK_DIR="/tmp/binance-mcp-rebuild"
GITHUB_USER="nirholas"
REPO_NAME="Binance-MCP"
echo "🚀 Rebuilding Binance-MCP with curated history..."
# Clean and create work directory
rm -rf "$WORK_DIR"
mkdir -p "$WORK_DIR"
cd "$WORK_DIR"
# Initialize fresh repo
git init
git config user.email "[email protected]"
git config user.name "nirholas"
# Function to add files and commit
commit_files() {
local message="$1"
shift
for file in "$@"; do
if [ -e "$REPO_DIR/$file" ]; then
mkdir -p "$(dirname "$file")"
cp -r "$REPO_DIR/$file" "$file"
git add "$file"
fi
done
git commit -m "$message" --allow-empty 2>/dev/null || true
}
# Function to add directory and commit
commit_dir() {
local message="$1"
local dir="$2"
if [ -d "$REPO_DIR/$dir" ]; then
mkdir -p "$dir"
cp -r "$REPO_DIR/$dir"/* "$dir/" 2>/dev/null || true
git add "$dir"
git commit -m "$message" 2>/dev/null || true
fi
}
echo "📦 Creating commits..."
# === ROOT CONFIG FILES ===
commit_files "🎯 Initialize project with package configuration" "package.json"
commit_files "⚙️ Add TypeScript compiler configuration" "tsconfig.json"
commit_files "🙈 Add Git ignore patterns for build artifacts" ".gitignore"
commit_files "📖 Add comprehensive README documentation" "README.md"
commit_files "📊 Add API coverage summary and implementation status" "API_COVERAGE_SUMMARY.md"
commit_files "📚 Add Binance REST API reference documentation" "binance-us-rest-api.md"
commit_files "🔧 Add server configuration template" "config.json"
# === CORE SOURCE FILES ===
commit_files "🚀 Add main entry point and server bootstrap" "src/index.ts"
commit_files "🔌 Add Binance API client and authentication" "src/binance.ts"
commit_files "⚡ Add initialization and startup logic" "src/init.ts"
# === CONFIG ===
commit_dir "🔐 Add Binance client configuration module" "src/config"
# === SERVER INFRASTRUCTURE ===
commit_files "🏗️ Add MCP server base class and core handlers" "src/server/base.ts"
commit_files "📡 Add SSE (Server-Sent Events) transport layer" "src/server/sse.ts"
commit_files "💻 Add STDIO transport for CLI integration" "src/server/stdio.ts"
# === UTILITIES ===
commit_dir "🛠️ Add logging and utility functions" "src/utils"
# === TOOLS ===
commit_dir "🔧 Add MCP tool definitions and handlers" "src/tools"
# === TRADING MODULES ===
commit_dir "📈 Add Spot trading module - market orders and trades" "src/modules/spot"
commit_dir "📊 Add Margin trading module - leveraged positions" "src/modules/margin"
commit_dir "🔮 Add USD-M Futures module - perpetual contracts" "src/modules/futures-usdm"
commit_dir "🪙 Add COIN-M Futures module - coin-margined contracts" "src/modules/futures-coinm"
commit_dir "🎲 Add Options trading module - derivatives" "src/modules/options"
# === ALGORITHMIC TRADING ===
commit_dir "🤖 Add Algo trading module - TWAP and VP strategies" "src/modules/algo"
# === COPY TRADING ===
commit_dir "👥 Add Copy Trading module - follow lead traders" "src/modules/copy-trading"
# === EARN & STAKING ===
commit_dir "💰 Add Staking module - ETH and SOL staking" "src/modules/staking"
commit_dir "🌾 Add Simple Earn module - flexible savings" "src/modules/simple-earn"
commit_dir "📈 Add Auto-Invest module - DCA strategies" "src/modules/auto-invest"
commit_dir "🎰 Add Dual Investment module - structured products" "src/modules/dual-investment"
# === LENDING ===
commit_dir "🏦 Add VIP Loan module - institutional lending" "src/modules/vip-loan"
commit_dir "💳 Add Crypto Loans module - collateral loans" "src/modules/crypto-loans"
# === PAYMENTS & TRANSFERS ===
commit_dir "💵 Add Fiat module - deposit and withdrawal" "src/modules/fiat"
commit_dir "💸 Add Pay module - Binance Pay transactions" "src/modules/pay"
commit_dir "🔄 Add Convert module - instant crypto swaps" "src/modules/convert"
commit_dir "👤 Add C2C module - peer-to-peer trading" "src/modules/c2c"
# === WALLET & ACCOUNT ===
commit_dir "👛 Add Wallet module - balances and transfers" "src/modules/wallet"
commit_dir "📊 Add Portfolio Margin module - unified margin" "src/modules/portfolio-margin"
commit_dir "🎁 Add Rebate module - commission history" "src/modules/rebate"
# === COLLECTIBLES & GIFTS ===
commit_dir "🖼️ Add NFT module - digital collectibles" "src/modules/nft"
commit_dir "🎀 Add Gift Card module - crypto gift cards" "src/modules/gift-card"
# === MINING ===
commit_dir "⛏️ Add Mining module - pool mining stats" "src/modules/mining"
echo "✅ All commits created!"
echo ""
echo "📋 Commit history:"
git log --oneline
echo ""
echo "🚀 Ready to push. Run:"
echo " cd $WORK_DIR"
echo " git remote add origin https://github.com/$GITHUB_USER/$REPO_NAME.git"
echo " git push origin main --force"
```
### scripts/rebuild-binance-us-mcp.sh
```bash
#!/bin/bash
set -e
# Rebuild Binance-US-MCP with individual commits for each file
REPO_DIR="/workspaces/universal-crypto-mcp/binance-us-mcp-server"
WORK_DIR="/tmp/binance-us-mcp-individual"
echo "🚀 Rebuilding Binance-US-MCP with individual file commits..."
rm -rf "$WORK_DIR"
mkdir -p "$WORK_DIR"
cd "$WORK_DIR"
git init
git config user.email "[email protected]"
git config user.name "nirholas"
commit_file() {
local file="$1"
local message="$2"
if [ -e "$REPO_DIR/$file" ]; then
mkdir -p "$(dirname "$file")"
cp "$REPO_DIR/$file" "$file"
git add "$file"
git commit -m "$message" 2>/dev/null || true
fi
}
echo "📦 Creating individual commits..."
# Root config files
commit_file "package.json" "🎯 Initialize package.json with Binance.US MCP server dependencies"
commit_file "package-lock.json" "🔒 Lock dependency versions for reproducible builds"
commit_file "tsconfig.json" "⚙️ Configure TypeScript for ES2022 and NodeNext modules"
commit_file "config.json" "🔧 Add server configuration with API endpoint settings"
commit_file "README.md" "📖 Add comprehensive README with setup and usage instructions"
# Core source files
commit_file "src/index.ts" "🚀 Create MCP server entry point with tool registration"
commit_file "src/config/binanceUsClient.ts" "🔐 Implement Binance.US API client with HMAC authentication"
commit_file "src/config/types.ts" "📝 Define TypeScript interfaces for API responses"
# Tool modules
commit_file "src/tools/general/index.ts" "🏓 Add general API tools - ping, time, exchange info"
commit_file "src/tools/market/index.ts" "📊 Implement market data tools - prices, orderbook, trades, klines"
commit_file "src/tools/account/index.ts" "👤 Add account tools - balances, trade history, status"
commit_file "src/tools/trade/index.ts" "💹 Implement core trading tools - orders, status, cancel"
commit_file "src/tools/trade/orders.ts" "✨ Add order placement with limit, market, and stop orders"
commit_file "src/tools/trade/oco.ts" "⚖️ Implement OCO (One-Cancels-Other) order management"
commit_file "src/tools/wallet/index.ts" "👛 Add wallet tools - deposits, withdrawals, transfers"
commit_file "src/tools/staking/index.ts" "💰 Implement staking tools for earning rewards"
commit_file "src/tools/otc/index.ts" "🏦 Add OTC trading tools for large block trades"
commit_file "src/tools/subaccount/index.ts" "👥 Implement sub-account management tools"
commit_file "src/tools/userdata-stream/index.ts" "📡 Add WebSocket user data stream management"
commit_file "src/tools/credit-line/index.ts" "💳 Implement credit line tools for institutional trading"
commit_file "src/tools/creditline/index.ts" "💳 Add alternative credit line module structure"
commit_file "src/tools/custodial-solution/index.ts" "🔒 Implement custodial solution for enterprise clients"
commit_file "src/tools/custodial/index.ts" "🔒 Add alternative custodial module structure"
# Documentation
commit_file "docs/README.md" "📚 Create documentation index and overview"
commit_file "docs/API.md" "🔌 Document complete Binance.US REST API reference"
commit_file "docs/API_CLIENT.md" "🌐 Explain API client configuration and authentication"
commit_file "docs/API_REFERENCE.md" "📋 Add detailed endpoint reference with parameters"
commit_file "docs/CONFIGURATION.md" "⚙️ Document server configuration options"
commit_file "docs/SECURITY.md" "🔐 Add security best practices and API key management"
commit_file "docs/ERROR_CODES.md" "⚠️ Document API error codes and troubleshooting"
commit_file "docs/TOOLS.md" "🛠️ List all available MCP tools with descriptions"
commit_file "docs/TOOLS_REFERENCE.md" "📖 Add comprehensive tool parameter reference"
commit_file "docs/TRADING.md" "📈 Document trading operations and order types"
commit_file "docs/TRADING_QUICK_REF.md" "⚡ Add quick reference for common trading tasks"
commit_file "docs/QUICK_REFERENCE.md" "📋 Create cheat sheet for frequent operations"
commit_file "docs/EXAMPLES.md" "💡 Add code examples and usage patterns"
commit_file "docs/PROMPT_EXAMPLES.md" "💬 Provide example prompts for Claude integration"
commit_file "docs/IMPLEMENTATION_GUIDE.md" "🏗️ Document implementation details and architecture"
commit_file "docs/CHANGELOG.md" "📝 Track version history and changes"
commit_file "docs/OTC_TRADING.md" "🏛️ Document OTC trading features for institutions"
commit_file "docs/CREDIT_LINE.md" "💳 Explain credit line features and requirements"
commit_file "docs/CUSTODIAL_SOLUTION.md" "🔒 Document custodial services for enterprises"
echo ""
echo "✅ All commits created!"
COMMIT_COUNT=$(git log --oneline | wc -l)
echo "📊 Total commits: $COMMIT_COUNT"
echo ""
git log --oneline | head -20
echo ""
echo "🚀 Ready to push!"
```
### scripts/setup-subtrees.sh
```bash
#!/bin/bash
# Setup script to push binance-us-mcp-server and binance-mcp-server as standalone repos
# while keeping them in the universal-crypto-mcp monorepo
set -e
GITHUB_USER="nirholas"
echo "============================================"
echo "Git Subtree Setup for Standalone Repos"
echo "============================================"
echo ""
echo "PREREQUISITE: Create these empty repos on GitHub first:"
echo " 1. https://github.com/${GITHUB_USER}/Binance-US-MCP (exists)"
echo " 2. https://github.com/${GITHUB_USER}/Binance-MCP"
echo ""
echo "Press Enter when ready, or Ctrl+C to cancel..."
read
# Add remotes for standalone repos
echo "Adding remotes..."
git remote add binance-us https://github.com/${GITHUB_USER}/Binance-US-MCP.git 2>/dev/null || echo "Remote 'binance-us' already exists"
git remote add binance https://github.com/${GITHUB_USER}/Binance-MCP.git 2>/dev/null || echo "Remote 'binance' already exists"
echo ""
echo "Current remotes:"
git remote -v
echo ""
echo "============================================"
echo "Pushing binance-us-mcp-server as standalone..."
echo "============================================"
git subtree push --prefix=binance-us-mcp-server binance-us main
echo ""
echo "============================================"
echo "Pushing binance-mcp-server as standalone..."
echo "============================================"
git subtree push --prefix=binance-mcp-server binance main
echo ""
echo "============================================"
echo "Done! Both repos have been pushed."
echo "============================================"
echo ""
echo "View them at:"
echo " https://github.com/${GITHUB_USER}/Binance-US-MCP"
echo " https://github.com/${GITHUB_USER}/Binance-MCP"
```
### scripts/sync-subtrees.sh
```bash
#!/bin/bash
# Sync script to push updates from monorepo subdirectories to standalone repos
# Run this after making changes to binance-us-mcp-server or binance-mcp-server
set -e
echo "============================================"
echo "Syncing subdirectories to standalone repos"
echo "============================================"
# Make sure we have the remotes
if ! git remote | grep -q "^binance-us$"; then
echo "Error: Remote 'binance-us' not found. Run setup-subtrees.sh first."
exit 1
fi
if ! git remote | grep -q "^binance$"; then
echo "Error: Remote 'binance' not found. Run setup-subtrees.sh first."
exit 1
fi
# Check for uncommitted changes
if ! git diff-index --quiet HEAD --; then
echo "Warning: You have uncommitted changes. Please commit them first."
exit 1
fi
echo ""
echo "Pushing binance-us-mcp-server..."
git subtree push --prefix=binance-us-mcp-server binance-us main
echo ""
echo "Pushing binance-mcp-server..."
git subtree push --prefix=binance-mcp-server binance main
echo ""
echo "============================================"
echo "Sync complete!"
echo "============================================"
```