Cisco

CISCO DISCORD BOT

Cisco is an AI-powered Discord bot with Amadeus blockchain integration and a pay-per-request system.

Try it Out

Read More on GitHub

────────────────────────PROBLEM STATEMENT────────────────────────

Discord communities struggle to integrate AI agents with real-time access to blockchain data due to:

• High API costs with traditional providers

• Lack of built-in payment mechanisms for AI services

• Absence of decentralized payment infrastructure

• Privacy concerns with centralized payment systems

Traditional solutions require complex payment gateways, expose user financial data, and do not provide transparent, per-use pricing models aligned with actual usage.

────────────────────────SOLUTION────────────────────────

Cisco is a Discord bot that seamlessly integrates Claude AI with Amadeus blockchain payments, enabling a true pay-per-request model where users pay with AMA for each blockchain query they make (similar to the x402 payment system).

Key benefits include:

• Encrypted private key storage

• Direct blockchain payments with no intermediaries

• Transparent transaction tracking

• Accountable AI-as-a-service directly inside Discord communities

────────────────────────USE CASES────────────────────────

1. Community Knowledge Base - Server members ask questions about rules, events, or topics, paying small amounts in AMA per query without subscriptions.

2. Blockchain Queries - Users query transactions, wallet balances, network statistics, and on-chain data.

3. AI-Powered Transfers - Natural language commands such as “send 10 AMA to Alice” with automated transaction signing.

4. Developer Testing - Test Amadeus payment flows and MCP integration inside a familiar Discord environment.

5. Educational Platforms - Students pay per question in educational Discord servers, ensuring fair access without upfront costs.

────────────────────────FEATURES────────────────────────

• Claude AI- powered responses with Amadeus blockchain tooling

• Auto-Generated Wallets - Each user receives a personal Amadeus wallet

• Encrypted Storage - Private keys encrypted using AES-256-GCM

• Pay-Per-Request - Automatic 10 AMA charge per query

• Usage Tracking - Transaction history and usage statistics

• MCP Integration - Direct blockchain access via Model Context Protocol

────────────────────────ARCHITECTURE────────────────────────

System Components:

Discord Layer

• Discord User

• Discord Bot Client

Application Layer

• Message Handler

• Command Handler

• Payment Service

• Claude AI Agent

Storage Layer

• MongoDB

• Encrypted Key Storage

Blockchain Layer

• MCP Client

• Amadeus Network

────────────────────────DATA FLOW────────────────────────

1. User Message - Discord bot receives a message or command.

2. Authentication - User is fetched or created in MongoDB along with an Amadeus wallet.

3. Command Routing - Determine whether the command is free (balance, deposit, stats) or paid.

4. Payment Processing (for paid queries)

• Pre-flight balance check

• Transaction creation via MCP

• Private key decryption from MongoDB

• Transaction signing using BLS12-381

• Submission to Amadeus blockchain

• Transaction hash recording

1. AI Processing - Query sent to Claude with MCP tool access.

2. Response - AI response returned to the Discord user.

3. Audit Trail - Usage and transaction data stored in MongoDB.

────────────────────────AGENT ROLES────────────────────────

The AI Agent Acts as the intelligent query processor with access to 19+ Amadeus blockchain tools via MCP.

Capabilities include:

• Understanding natural language requests

• Selecting appropriate blockchain tools

• Executing multi-step operations (for example, balance check followed by transfer)

• Providing conversational confirmations for transactions

• Handling errors gracefully and explaining blockchain behavior

────────────────────────HOW AMADEUS IS USED────────────────────────

Current Implementation

1. Amadeus SDK Integration - The @amadeus-protocol/sdk (v1.0.2) is used for:

• BLS12-381 key generation

• Transaction building compatible with the Amadeus network

• Atomic unit conversion using toAtomicAma()

1. MCP Server Connected to the official Amadeus MCP server (mcp.ama.one).

Core tools used include:

• create_transaction

• submit_transaction

• get_account_balance

• get_transaction

• get_transaction_history

• get_chain_stats

• claim_testnet_ama

Custom tools built:

• transfer_ama

• get_user_info

• get_user_balance

• get_user_stats

1. Wallet Management and Security

• Wallets generated automatically on first interaction

• Private keys encrypted with AES-256-GCM before storage

• Signing handled via BLS12-381 cryptography

• No manual wallet setup required

────────────────────────FUTURE AMADEUS FEATURES────────────────────────

Advanced features such as uPoW, WASM runtime, state proofs, agent identity, oracle streams, and swarm coordination are hardware-level features and not currently applicable to the Discord bot use case.

The implementation focuses on core SDK and MCP capabilities to enable secure, transparent, decentralized payments.

────────────────────────MONETIZATION PATH────────────────────────

Current Revenue Model

• Pay-per-request: 10 AMA per AI query

• Automated blockchain payments to system wallet

• Linear revenue scaling with user growth

• No subscriptions

Cost Structure

• Anthropic API: approximately $0.003 per request

• Amadeus transaction fees: minimal

• Infrastructure: approximately $50 per month

Revenue Projections

• Break-even at around 17,000 requests per month

• Example: 100 active users making 5 queries per day equals 15,000 requests monthly

• Estimated profit margin around 40 percent

• Linear scalability with no major infrastructure bottlenecks

Future Revenue Streams

• Premium tiers with monthly allowances

• White-label licensing

• Enterprise features

• API access

• Community revenue sharing

────────────────────────TRADEOFFS AND FEASIBILITY────────────────────────

What Works Today

• Fully functional blockchain payments

• Claude AI integration with MCP tooling

• Secure wallet generation and signing

• MongoDB persistence

• Discord slash commands

Battle-Tested Security

• AES-256-GCM encryption

• Balance validation

• Full transaction audit trail

• No private key exposure

Current Limitations

Technical constraints include:

• Single bot instance

• No automated refunds

• Synchronous processing with 3–5 second confirmations

User experience constraints include:

• Initial wallet funding required

• No proactive balance alerts

• Sequential request handling

Future Requirements

• Faster transaction finality

• Batch transactions

• Load balancing

• Monitoring and alerting

• Automated refund mechanisms

────────────────────────DESIGN DECISIONS────────────────────────

Why Prepaid Payments

• Prevents free usage abuse

• Simple user experience

• No billing complexity

Why MongoDB for Keys

• Fast lookups

• Flexible schema

• Easy backups

Why Discord Instead of a Web App

• No new accounts required

• Users already active

• Familiar chat interface

────────────────────────QUICK START────────────────────────

Prerequisites

• Node.js 20 or higher

• MongoDB

• Discord Bot Token

• Anthropic API Key

Installation Steps

• Install dependencies

• Generate encryption key

• Configure environment variables

• Run development server

────────────────────────BOT COMMANDS────────────────────────

• /balanceCheck AMA wallet balance

• /depositGet wallet address for deposits

• /statsView usage statistics

• /faucetClaim daily testnet AMA

────────────────────────PAYMENT FLOW────────────────────────

1. First interaction creates an Amadeus wallet

2. User deposits AMA

3. Bot signs and submits payment

4. Payment confirmation received

5. Claude processes request

6. Response delivered and recorded

────────────────────────WALLET SECURITY────────────────────────

• Private keys encrypted at rest

• Encryption key stored in environment variables

• Keys decrypted only during signing

• Never logged or exposed

────────────────────────AVAILABLE MCP TOOLS────────────────────────

The bot has access to over 19 Amadeus blockchain tools including transaction creation, submission, balance checks, chain statistics, and transaction history queries.

────────────────────────TROUBLESHOOTING────────────────────────

Payment Failed

• Check wallet balance

• Confirm sufficient AMA

• Verify deposit address

Encryption Issues

• Ensure correct encryption key length

• Regenerate key if needed

MongoDB Errors

• Confirm database is running

• Verify connection string

────────────────────────LICENSE────────────────────────

MIT License