# Taifoon MCP Skills & Capabilities

**Document Type:** AI Agent Capability Manifest
**Protocol:** Model Context Protocol (MCP)
**Version:** 1.0
**Last Updated:** 2026-03-12
**Service:** taifoon-mcp
**Endpoint:** https://taifoon.dev/api/mcp/api

---

## Overview

Taifoon provides AI-native access to cross-chain blockchain infrastructure through 9 MCP tools. Query 38+ blockchains, calculate signal pricing, explore MMR proofs, and navigate the Taifoon ecosystem through natural language.

**Key Capabilities:**
- Chain discovery across 38 networks (EVM, Bitcoin, Solana, Substrate, Cosmos)
- Signal pricing calculation (7 signal types)
- Ecosystem navigation (6 projects)
- Pricing tier comparison and recommendations
- MMR proof system knowledge

---

## Available Tools

### 1. list_supported_chains()

**Description:** Returns all 38 supported blockchain networks with metadata

**Returns:** Array of chain objects

**Schema:**
```json
{
  "name": "string",
  "token": "string",
  "decimals": number,
  "category": "evm|evm_l2|evm_sidechain|utxo|solana|substrate|cosmos",
  "rpc": "string (URL)",
  "explorer": "string (URL)",
  "ss58_prefix": number (optional, Substrate only)
}
```

**Categories:**
- `evm`: 7 chains (Ethereum, Avalanche, BNB, etc.)
- `evm_l2`: 10 chains (Arbitrum, Base, Optimism, zkSync, etc.)
- `evm_sidechain`: 1 chain (Polygon)
- `utxo`: 1 chain (Bitcoin)
- `solana`: 1 chain (Solana)
- `substrate`: 9 chains (Polkadot, Kusama, Moonbeam, etc.)
- `cosmos`: 9 chains (Cosmos Hub, Osmosis, Celestia, etc.)

**Use Cases:**
- "What chains does Taifoon support?"
- "List all EVM L2s"
- "Show me Substrate chains"

---

### 2. chain_info(name: string)

**Description:** Get detailed information for a specific blockchain

**Parameters:**
- `name` (required): Chain name (lowercase, e.g., "ethereum", "bitcoin", "polkadot")

**Returns:** Chain object with RPC endpoint, explorer URL, token info, decimals

**Use Cases:**
- "Get info for Bitcoin"
- "What's the RPC for Ethereum?"
- "Show me Polkadot details"

---

### 3. filter_chains_by_category(category: string)

**Description:** Filter chains by type/ecosystem

**Parameters:**
- `category` (required): One of: evm, evm_l2, evm_sidechain, utxo, solana, substrate, cosmos, other

**Returns:** Filtered array of chain objects

**Use Cases:**
- "Show all EVM chains"
- "List Cosmos ecosystem"
- "Get Substrate parachains"

---

### 4. list_signal_types()

**Description:** Returns all 7 available signal types with pricing and metadata

**Signal Types:**
1. **gas_price** - Real-time gas price oracle ($0.001/signal)
2. **finality** - Block finality notifications ($0.003/signal)
3. **twap** - Time-weighted average price ($0.005/signal)
4. **mev** - MEV opportunity detection ($0.010/signal)
5. **whale** - Large transaction monitoring ($0.002/signal)
6. **token_launch** - New token detection ($0.008/signal)
7. **mmr_proof** - MMR proof generation ($0.015/signal)

**Returns:** Array of signal type objects with pricing, description, frequency

**Use Cases:**
- "What signal types are available?"
- "List all signals with pricing"
- "Explain finality signals"

---

### 5. get_signal_price(signal_type: string)

**Description:** Get detailed pricing for a specific signal type

**Parameters:**
- `signal_type` (required): One of: gas_price, finality, twap, mev, whale, token_launch, mmr_proof

**Returns:** Signal pricing object with cost per signal, recommended frequency, use cases

**Use Cases:**
- "How much do finality signals cost?"
- "Price for MMR proofs"
- "What's the cost of whale monitoring?"

---

### 6. get_pricing_tiers()

**Description:** Returns all pricing plans with signal allocations

**Pricing Tiers:**

**PayAsYouGo:**
- Cost: Variable (pay per signal)
- Signals: Unlimited
- Best for: Testing, low volume

**Monthly ($99/month):**
- Cost: $99/month
- Signals: 60,000/month included
- Overage: $0.002/signal
- Best for: Production apps

**Annual ($999/year):**
- Cost: $999/year ($83/month)
- Signals: 1,998,000/year included
- Overage: $0.001/signal
- Best for: High-volume protocols

**Returns:** Array of pricing tier objects

**Use Cases:**
- "Compare pricing plans"
- "What's included in the Monthly plan?"
- "Annual vs Monthly pricing"

---

### 7. calculate_usage_cost(signal_type: string, quantity: number)

**Description:** Smart cost calculator with plan recommendations

**Parameters:**
- `signal_type` (required): Signal type to calculate
- `quantity` (required): Number of signals

**Returns:** Cost breakdown with plan recommendations

**Logic:**
- Calculates PayAsYouGo cost
- Compares with Monthly/Annual plans
- Recommends best-value tier
- Shows breakeven analysis

**Use Cases:**
- "Calculate cost for 10k finality signals"
- "What's the best plan for 50k whale signals per month?"
- "Compare pricing for 100k MMR proofs"

---

### 8. list_ecosystem_projects()

**Description:** Returns all 6 Taifoon ecosystem projects

**Projects:**
1. **taifoon-sdk** - TypeScript SDK for integrating signals and proofs
2. **taifoon-eco** - Ecosystem tools and utilities
3. **taifoon-light-clients** - On-chain Solidity verifiers (V5ProofVerifier.sol, MMRVerifier.sol)
4. **da-api** - Data availability API and proof infrastructure (Rust)
5. **spinner** - Multi-chain block header collector with MMR proofs (Rust)
6. **taifoon-mcp** - Model Context Protocol server (this service)

**Returns:** Array of project objects with name, description, location, tech stack

**Use Cases:**
- "What is taifoon-sdk?"
- "List all ecosystem projects"
- "Show me the tech stack"

---

### 9. ecosystem_project_info(project_name: string)

**Description:** Get detailed information about a specific ecosystem project

**Parameters:**
- `project_name` (required): One of: taifoon-sdk, taifoon-eco, taifoon-light-clients, da-api, spinner, taifoon-mcp

**Returns:** Detailed project object with:
- Architecture details
- Key components
- Integration guides
- Repository location
- Technology stack

**Use Cases:**
- "Explain the da-api architecture"
- "How do light clients work?"
- "What's in the spinner project?"

---

## Integration Examples

### Example 1: Chain Discovery

**Query:** "What Polkadot chains does Taifoon support?"

**Tool Flow:**
```
list_supported_chains() → filter_chains_by_category("substrate")
```

**Expected Response:**
```
Taifoon supports 9 Substrate chains:
- Polkadot (relay chain) - DOT, 10 decimals
- Kusama - KSM, 12 decimals
- Asset Hub - DOT, 10 decimals
- Bridge Hub - DOT, 10 decimals
- Moonbeam - GLMR, 18 decimals
- Acala - ACA, 12 decimals
- Astar - ASTR, 18 decimals
- Hydration - HDX, 12 decimals
- Westend (testnet) - WND, 12 decimals

All have real-time block header sync with MMR proof anchoring.
```

---

### Example 2: Pricing Optimization

**Query:** "Calculate cost for 10,000 finality signals per month"

**Tool Flow:**
```
get_signal_price("finality") → calculate_usage_cost("finality", 10000)
```

**Expected Response:**
```
Finality Signal Pricing:
- PayAsYouGo: 10,000 × $0.003 = $30/month
- Monthly Plan: $99/month (includes 60k signals) ✓ RECOMMENDED
- Annual Plan: $999/year = $83/month (includes 166k/month)

Recommendation: Monthly plan ($99) covers your usage with 50k signals to spare.
```

---

### Example 3: Smart Contract Integration

**Query:** "I want to integrate Taifoon proofs into my Ethereum contract"

**Tool Flow:**
```
ecosystem_project_info("taifoon-light-clients") → ecosystem_project_info("da-api")
```

**Expected Response:**
```
For Ethereum smart contract integration:

1. taifoon-light-clients (Solidity)
   - V5ProofVerifier.sol - Verify V5 proofs on-chain
   - MMRVerifier.sol - Verify MMR proofs
   - Deployed on: Ethereum, Arbitrum, Base, Optimism, Polygon
   - Gas-optimized verification

2. da-api (Rust)
   - Proof assembly and generation
   - V5 proof anchors
   - REST API: https://api.taifoon.dev
   - Endpoints: /v5/proof, /mmr/proof

Integration steps:
1. Deploy or import V5ProofVerifier.sol
2. Fetch proofs from da-api
3. Call verifyProof(bytes proof, bytes32 commitment)
4. Proof anchors every 100 blocks (~20 minutes)
```

---

## API Endpoints

**Base URL:** `https://taifoon.dev/api/mcp/api`

**REST Endpoints:**
- `GET /health` - Health check
- `GET /api/chains` - List all chains (JSON)
- `POST /api/chains/info` - Get chain details
- `GET /api/signals` - List signal types
- `GET /api/pricing` - Get pricing tiers
- `POST /api/calculate-cost` - Calculate usage cost
- `GET /api/ecosystem` - List projects
- `POST /api/chat` - Chat with AI assistant (requires DeepSeek credits)

**Chat Endpoint:**
```bash
curl -X POST https://taifoon.dev/api/mcp/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What chains does Taifoon support?",
    "conversation_history": []
  }'
```

---

## Supported Networks (38 Total)

### EVM (7)
- Ethereum, Avalanche, BNB Chain, Fantom, Gnosis, Celo, Cronos

### EVM L2 (10)
- Arbitrum, Base, Optimism, zkSync Era, Polygon zkEVM, Linea, Scroll, Mantle, Blast, Mode

### EVM Sidechain (1)
- Polygon

### UTXO (1)
- Bitcoin

### Solana (1)
- Solana

### Substrate (9)
- Polkadot, Kusama, Asset Hub, Bridge Hub, Collectives, Moonbeam, Acala, Astar, Hydration, Westend

### Cosmos (9)
- Cosmos Hub, Osmosis, Celestia, dYdX, Injective, Sei, Neutron, Akash, Kujira

---

## Technical Architecture

**Language:** Rust (2021 edition)
**Protocol:** Model Context Protocol (MCP)
**Modes:**
- stdio: JSON-RPC over stdin/stdout (Claude Desktop)
- HTTP: REST API with DeepSeek chat

**Data Sources:**
- Static: Embedded chain/pricing data (Phase 1)
- Dynamic: scanner.taifoon.dev API (Phase 2)

**Dependencies:**
- Core: Minimal Rust stdlib
- HTTP mode: axum, tokio, serde

---

## AI Agent Guidelines

**When to Use:**
- Cross-chain blockchain queries
- Signal pricing calculations
- Taifoon ecosystem navigation
- Smart contract integration guidance
- MMR proof system explanations

**Best Practices:**
- Use `list_supported_chains()` first for chain discovery
- Chain `filter_chains_by_category()` for targeted queries
- Use `calculate_usage_cost()` for pricing recommendations
- Reference specific chains by lowercase name
- Combine tools for complex queries (e.g., chain info + pricing)

**Response Format:**
- Be concise and technical
- Include specific numbers (chain counts, prices)
- Provide actionable recommendations
- Reference tool names when explaining logic
- Use structured lists for clarity

---

## Metadata

**Service Status:** Production
**Uptime:** 99.9%
**Response Time:** <100ms (embedded data)
**Rate Limit:** None (Phase 1)
**Authentication:** None required (Phase 1)

**Contact:**
- Website: https://taifoon.io
- Docs: https://docs.taifoon.io
- GitHub: https://github.com/taifoon-io/taifoon-mcp
- Discord: https://discord.gg/QCtzUwNGw4

---

**Built for AI agents and crypto protocols who want deterministic access to cross-chain infrastructure.**