@aicryptorisk/mcp-server 1.0.0 → 1.1.0

package/MARKETING.md

@@ -0,0 +1,231 @@
+# Marketing Guide: AI Crypto Risk MCP Server
+
+## Positioning Statement
+
+**For:** AI agent developers, crypto trading bot builders, and DeFi applications
+
+**Problem:** AI agents executing crypto trades have no security layer - they can unknowingly trade into honeypots, rugpulls, and scam tokens
+
+**Solution:** AI Crypto Risk MCP Server - the security checkpoint that prevents your agent from making catastrophic trades
+
+**Differentiator:** The only MCP server purpose-built for crypto risk analysis with real-time on-chain data
+
+---
+
+## Key Messages
+
+### Primary Message
+> "The Security Layer for Agentic Crypto Trading"
+
+### Supporting Messages
+1. **For Agent Developers:** "Give your trading agents a brain for security"
+2. **For DeFi Projects:** "Reduce liability by documenting due diligence"
+3. **For Individual Users:** "Never trade into a scam again"
+
+---
+
+## Marketplace Listing Copy
+
+### Short Description (150 chars)
+```
+Real-time crypto scam detection for AI agents. Analyze tokens for honeypots, rugpulls, and red flags before any trade. Multi-chain support.
+```
+
+### Medium Description (300 chars)
+```
+Stop your AI agent from trading into scams. AI Crypto Risk MCP Server provides instant risk analysis for crypto tokens across Ethereum, BSC, Polygon, Arbitrum, Base, and Solana. Detect honeypots, blacklist functions, hidden ownership, and 20+ red flags before any transaction.
+```
+
+### Full Description
+```
+AI Crypto Risk MCP Server is the security layer your AI trading agent needs.
+
+WHAT IT DOES:
+- Analyzes any crypto token for scam indicators in real-time
+- Returns risk scores (0-100) with detailed red flags
+- Supports 6 major chains: Ethereum, BSC, Polygon, Arbitrum, Base, Solana
+- Detects honeypots, blacklist functions, hidden owners, high taxes, and more
+
+WHY YOU NEED IT:
+- Prevent catastrophic losses from scam tokens
+- Document due diligence for every trade
+- Add security without slowing down your agent
+- Liability protection for DeFi applications
+
+TOOLS INCLUDED:
+1. analyze_crypto_risk - Instant token risk assessment
+2. request_deep_research - Comprehensive 4-pillar analysis via email
+3. get_supported_chains - List supported blockchains
+
+PRICING:
+Free tier: 10 scans/day
+Paid plans from $9/month for 50+ scans/day
+
+Built for the agentic economy. Trade safe.
+```
+
+---
+
+## Target Audiences
+
+### 1. AI Agent Developers
+**Pain Point:** Building trading agents without security checks
+**Message:** "Your agent is only as smart as its data. Give it risk intelligence."
+**CTA:** "Add security in 5 minutes"
+
+### 2. DeFi Protocol Teams
+**Pain Point:** Users getting scammed through their platform
+**Message:** "Protect your users. Protect your reputation."
+**CTA:** "Integrate risk checks into your protocol"
+
+### 3. Crypto Trading Bot Builders
+**Pain Point:** Bots trading into honeypots automatically
+**Message:** "Stop your bot from buying what it can't sell"
+**CTA:** "Add the honeypot check"
+
+### 4. Claude/AI Power Users
+**Pain Point:** Manually researching every token before trading
+**Message:** "Let Claude check risks for you automatically"
+**CTA:** "Install in 2 minutes"
+
+---
+
+## Marketplace Listing Tips
+
+### npm (npmjs.com)
+- [x] Clear package name: `@aicryptorisk/mcp-server`
+- [x] Badges: version, license
+- [x] Quick start in first 3 lines
+- [x] Keywords: mcp, crypto, risk, scam, ai, claude, security, trading
+- [ ] Add logo/banner image
+- [ ] Weekly download stats (build over time)
+
+### GitHub
+- [ ] Add topics: `mcp`, `crypto`, `ai-agents`, `claude`, `security`
+- [ ] Create releases with changelogs
+- [ ] Add contributing guidelines
+- [ ] Issue templates for bugs/features
+- [ ] GitHub Actions for CI/CD
+
+### Claude Plugin Directory (when available)
+- Emphasize Claude Desktop integration
+- Include example prompts
+- Show before/after scenarios
+- Highlight the Safe-Trade skill
+
+### MCP Server Registries
+- Submit to: mcp.run, awesome-mcp-servers
+- Include demo GIF showing analysis in action
+- Provide test contract addresses for reviewers
+
+### Product Hunt
+**Tagline:** "The security layer for AI crypto trading"
+**First Comment:**
+```
+Hey PH!
+
+We built this because AI agents are starting to trade crypto autonomously -
+but they have zero security awareness. They'll happily buy honeypots.
+
+AI Crypto Risk MCP adds a mandatory security checkpoint before any trade.
+Works with Claude Desktop in 2 minutes.
+
+Free tier: 10 scans/day
+Would love your feedback!
+```
+
+### Twitter/X Threads
+```
+Thread idea:
+
+1/ Your AI agent just bought a honeypot.
+   Now it can't sell.
+   Your funds are gone.
+
+   This is happening every day. Here's how to prevent it: 🧵
+
+2/ We built an MCP server that checks tokens before trading.
+   It catches:
+   - Honeypots
+   - Blacklist functions
+   - Hidden ownership
+   - Rugpull patterns
+
+3/ Takes 2 minutes to add to Claude Desktop.
+   npm install -g @aicryptorisk/mcp-server
+
+4/ Free tier: 10 checks/day
+   Paid: up to 200/day
+
+   Link in bio. Stay safe. 🛡️
+```
+
+---
+
+## Demo Script
+
+### Quick Demo (30 seconds)
+1. Show Claude Desktop
+2. Ask: "Is this token safe? 0xdAC17F958D2ee523a2206206994597C13D831ec7"
+3. Show the risk analysis response
+4. "That's USDT - score 48, some flags because Tether can freeze accounts"
+
+### Full Demo (2 minutes)
+1. Show a known scam token (score 90+)
+2. Show the red flags detected
+3. Show Claude refusing to help trade it
+4. Show a safe token for comparison
+5. Explain the Safe-Trade skill
+
+---
+
+## Competitive Positioning
+
+| Feature | AI Crypto Risk | GoPlus Direct | Manual Research |
+|---------|---------------|---------------|-----------------|
+| MCP Integration | Yes | No | No |
+| AI Agent Ready | Yes | API only | No |
+| Pre-trade Enforcement | Yes (Skill) | No | No |
+| Multi-chain | 6 chains | 20+ chains | Varies |
+| Price | From $0 | From $0 | Free (time cost) |
+
+**Our advantage:** Purpose-built for AI agents, not just an API.
+
+---
+
+## Launch Checklist
+
+- [x] npm package published
+- [x] README with quick start
+- [x] Pricing tiers defined
+- [x] API key dashboard
+- [x] Safe-Trade skill created
+- [ ] Demo video
+- [ ] Landing page section
+- [ ] Blog post announcement
+- [ ] Twitter thread
+- [ ] Submit to MCP registries
+- [ ] Product Hunt launch
+
+---
+
+## Metrics to Track
+
+1. **npm downloads** - Weekly installs
+2. **API key signups** - Conversion from visitors
+3. **Daily API calls** - Usage and growth
+4. **Upgrade rate** - Free to paid conversion
+5. **Churn** - Subscription cancellations
+
+---
+
+## Future Roadmap (for marketing)
+
+- Q1: Launch + Claude Desktop integration
+- Q2: Plugin marketplace listings
+- Q3: SDK for custom integrations
+- Q4: Real-time alerting for portfolio monitoring
+
+---
+
+*Last updated: February 2026*

package/README.md

@@ -1,133 +1,134 @@
-# AI Crypto Risk MCP Server
-
-An MCP (Model Context Protocol) server that provides AI assistants with cryptocurrency risk analysis capabilities.
-
-## Features
-
-- **Token Risk Analysis**: Analyze any crypto token for scam indicators
-- **Deep Research**: Request comprehensive 4-pillar research reports
-- **Multi-Chain Support**: Ethereum, BSC, Polygon, Arbitrum, Base, Solana
-- **Usage Metering**: Built-in API key authentication and usage tracking
-
-## Installation
-
-```bash
-# From npm (when published)
-npm install -g @aicryptorisk/mcp-server
-
-# Or from source
-cd mcp-server
-npm install
-```
-
-## Configuration
-
-### For Claude Desktop
-
-Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac or `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
-
-```json
-{
-  "mcpServers": {
-    "aicryptorisk": {
-      "command": "node",
-      "args": ["/path/to/mcp-server/index.js"],
-      "env": {
-        "AICRYPTORISK_API_KEY": "your-api-key-here"
-      }
-    }
-  }
-}
-```
-
-### For Claude Code
-
-Add to your project's `.claude/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "aicryptorisk": {
-      "command": "node",
-      "args": ["./mcp-server/index.js"],
-      "env": {
-        "AICRYPTORISK_API_KEY": "your-api-key-here"
-      }
-    }
-  }
-}
-```
-
-## Available Tools
-
-### `analyze_crypto_risk`
-
-Analyze a token for scam indicators and risk factors.
-
-**Input:**
-- `contract_address` (required): Token contract address
-- `chain` (optional): Blockchain network (default: ethereum)
-- `coin_name` (optional): Name for better context
-
-**Returns:**
-- Risk score (0-100)
-- Risk level (Low/Medium/High/Critical)
-- Red flags and warnings
-- Recommendations
-
-### `request_deep_research`
-
-Request comprehensive 4-pillar analysis (delivered via email).
-
-**Input:**
-- `contract_address` (required): Token contract address
-- `chain` (required): Blockchain network
-- `coin_name` (required): Token name
-- `symbol` (optional): Token symbol
-- `email` (required): Email for report delivery
-
-### `get_supported_chains`
-
-Get list of supported blockchain networks.
-
-## Pricing Tiers
-
-| Tier | Daily Limit | Price |
-|------|-------------|-------|
-| Free | 10 scans | $0 |
-| Pro | 100 scans | $19/mo |
-| Enterprise | Unlimited | Contact us |
-
-Get your API key at: https://aicryptorisk.com/api-keys
-
-## Example Usage
-
-Once configured, you can ask Claude:
-
-> "Analyze this token for scam risk: 0x1234...abcd on ethereum"
-
-> "Research this new memecoin PEPE2 at 0xabc... on BSC and send the report to my@email.com"
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Run locally (dev mode, no auth required)
-npm start
-
-# With auth (production)
-SUPABASE_URL=your-url \
-SUPABASE_SERVICE_ROLE_KEY=your-key \
-AICRYPTORISK_API_KEY=test-key \
-npm start
-```
-
-## Database Setup
-
-Run `schema.sql` in your Supabase SQL editor to create the required tables for API key management and usage tracking.
-
-## License
-
-MIT
+# AI Crypto Risk MCP Server
+
+**The Security Layer for Agentic Crypto Trading**
+
+Stop your AI agent from trading into scams. This MCP server provides real-time cryptocurrency risk analysis, protecting users and agents from honeypots, rugpulls, and malicious smart contracts.
+
+[![npm version](https://img.shields.io/npm/v/@aicryptorisk/mcp-server.svg)](https://www.npmjs.com/package/@aicryptorisk/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why Use This?
+
+- **Prevent Losses**: Detect honeypots, blacklist functions, and rugpull patterns before trading
+- **Agent Safety**: Give your AI trading agents a security checkpoint
+- **Liability Shield**: Document due diligence for every transaction
+- **Multi-Chain**: Ethereum, BSC, Polygon, Arbitrum, Base, Solana
+
+## Quick Start
+
+```bash
+npm install -g @aicryptorisk/mcp-server
+```
+
+Get your API key at: **https://aicryptorisk.com/api-keys**
+
+### Claude Desktop Configuration
+
+Add to `claude_desktop_config.json`:
+
+**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "aicryptorisk": {
+      "command": "npx",
+      "args": ["@aicryptorisk/mcp-server"],
+      "env": {
+        "AICRYPTORISK_API_KEY": "acr_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Done.
+
+## Tools Available
+
+### `analyze_crypto_risk`
+
+Instant risk analysis for any token.
+
+```
+Input:
+  - contract_address: "0x..." (required)
+  - chain: "ethereum" | "bsc" | "polygon" | "arbitrum" | "base" | "solana"
+  - coin_name: "Token Name" (optional)
+
+Output:
+  - Risk score: 0-100 (higher = more dangerous)
+  - Verdict: Low Risk / Elevated Risk / High Risk / Critical Risk
+  - Red flags: Honeypot, blacklist, hidden owner, high tax, etc.
+  - Positive signals: Verified source, renounced ownership, etc.
+```
+
+### `request_deep_research`
+
+Comprehensive 4-pillar analysis delivered via email:
+1. On-Chain Security
+2. Social Media Intelligence
+3. Institutional Interest
+4. Off-Chain Investigation
+
+### `get_supported_chains`
+
+Returns list of supported blockchain networks.
+
+## Example Prompts
+
+Once configured, just ask Claude:
+
+> "Check if this token is safe: 0xdAC17F958D2ee523a2206206994597C13D831ec7"
+
+> "Analyze the risk of trading PEPE on ethereum"
+
+> "Before I swap, verify this contract: 0x..."
+
+## Pricing
+
+| Plan | API Calls/Day | Keys | Price |
+|------|---------------|------|-------|
+| Free | 10 | 2 | $0 |
+| Monthly | 50 | 3 | $9/mo |
+| Yearly | 100 | 5 | $69/yr |
+| Lifetime | 200 | 10 | $199 once |
+
+**[Get Your API Key](https://aicryptorisk.com/api-keys)**
+
+## The Safe-Trade Skill
+
+For maximum protection, pair this MCP with our **Safe-Trade Skill** that enforces mandatory risk checks before any transaction:
+
+```yaml
+# .claude/skills/safe-trade/SKILL.md
+---
+name: safe-trade
+description: Check crypto risk before any transaction
+---
+BEFORE any crypto transaction, run analyze_crypto_risk.
+If score > 75: REFUSE to proceed.
+```
+
+## Security
+
+- API keys are hashed with SHA-256
+- Usage tracked per key for billing
+- Rate limiting prevents abuse
+- No sensitive data stored
+
+## Support
+
+- Documentation: https://aicryptorisk.com/docs
+- API Keys: https://aicryptorisk.com/api-keys
+- Email: jason@aicryptorisk.com
+- GitHub: https://github.com/djangamane/montecrypto
+
+## License
+
+MIT - Use freely in your agents and applications.
+
+---
+
+**Built for the Agentic Economy.** Protect your users. Protect your agents. Trade safe.