# claw-mcp-toolkit

**One install. 26 tools. Your AI agent is ready.**

The Swiss Army Knife MCP server for AI agents. 5 modules, 26 tools, zero API keys required.

Works with Claude, ChatGPT, Gemini, and any MCP-compatible AI.

## Installation

```bash
# Install from GitHub (recommended)
npm install -g github:ElromEvedElElyon/claw-mcp-toolkit

# Or run directly with npx
npx github:ElromEvedElElyon/claw-mcp-toolkit

# Or install from GitHub Packages (@elromevedelelyon scope)
npm install -g @elromevedelelyon/claw-mcp-toolkit --registry=https://npm.pkg.github.com

# Or install from release tarball
npm install -g https://github.com/ElromEvedElElyon/claw-mcp-toolkit/releases/download/v1.0.0/elromevedelelyon-claw-mcp-toolkit-1.0.0.tgz
```

## Quick Start with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "claw-mcp-toolkit": {
      "command": "npx",
      "args": ["-y", "github:ElromEvedElElyon/claw-mcp-toolkit"]
    }
  }
}
```

Or if installed globally:

```json
{
  "mcpServers": {
    "claw-mcp-toolkit": {
      "command": "claw-mcp-toolkit"
    }
  }
}
```

## 26 Tools Across 5 Modules

### Crypto (6 tools)
| Tool | Description |
|------|-------------|
| `crypto_price` | Real-time price, market cap, 24h change for any coin |
| `crypto_trending` | Top 7 trending coins on CoinGecko |
| `crypto_fear_greed` | Fear & Greed Index (0-100) |
| `crypto_market_overview` | Global market cap, BTC dominance, active coins |
| `crypto_price_history` | Historical prices (1d to 365d) with high/low |
| `crypto_search` | Search coins by name or symbol |

### Web (5 tools)
| Tool | Description |
|------|-------------|
| `web_fetch` | Fetch and extract readable text from any URL |
| `web_extract_links` | Extract all links from a webpage |
| `web_dns_lookup` | DNS record lookup via Google DNS |
| `web_ssl_check` | Check SSL certificate and security headers |
| `web_seo_check` | SEO analysis (title, meta, headings, images) |

### Social (5 tools)
| Tool | Description |
|------|-------------|
| `social_generate_tweet` | Generate high-engagement tweets (5 styles) |
| `social_thread_builder` | Build Twitter/X thread structure (3-10 tweets) |
| `social_content_calendar` | 7-day content calendar for any platform |
| `social_hashtag_research` | Hashtag research with platform-specific tips |
| `social_engagement_analyzer` | Engagement rate analysis with recommendations |

### Finance (5 tools)
| Tool | Description |
|------|-------------|
| `finance_stock_price` | Real-time stock prices (Yahoo Finance) |
| `finance_forex_rate` | Currency exchange rates (150+ currencies) |
| `finance_portfolio_tracker` | Portfolio allocation calculator |
| `finance_expense_log` | Formatted expense entries for tracking |
| `finance_invoice_generator` | Professional invoice generation (markdown) |

### Productivity (5 tools)
| Tool | Description |
|------|-------------|
| `productivity_pomodoro` | Pomodoro timer session planner |
| `productivity_task_breakdown` | Break complex tasks into sub-tasks |
| `productivity_note` | Structured note-taking with tags |
| `productivity_calendar_event` | iCal event generator |
| `productivity_reminder` | Priority-based reminder system |

## Why claw-mcp-toolkit?

- **Zero API keys** for core functionality (uses public APIs)
- **Zero config** - just `npx` and go
- **26 real tools** that agents actually need
- **5 modules** covering the most common agent tasks
- **Lightweight** - minimal dependencies
- **TypeScript** - full type safety
- **MIT License** - use it anywhere

## Architecture

```
claw-mcp-toolkit/
  src/
    index.ts              # Entry point
    modules/
      crypto.ts           # 6 tools (CoinGecko, Fear & Greed)
      web.ts              # 5 tools (fetch, DNS, SSL, SEO)
      social.ts           # 5 tools (tweets, threads, calendar)
      finance.ts          # 5 tools (stocks, forex, invoices)
      productivity.ts     # 5 tools (pomodoro, tasks, notes)
    utils/
      fetch.ts            # HTTP helper with timeout
      format.ts           # Currency, number, table formatters
```

## Development

```bash
git clone https://github.com/ElromEvedElElyon/claw-mcp-toolkit.git
cd claw-mcp-toolkit
npm install
npm run dev    # Run with tsx (hot reload)
npm run build  # Build to dist/
npm start      # Run built version
```

## Comparison

| Feature | claw-mcp-toolkit | Single-purpose MCPs |
|---------|-----------------|-------------------|
| Tools | 26 | 1-5 each |
| Install | 1 command | Multiple installs |
| API Keys | None required | Often required |
| Modules | 5 integrated | Separate repos |
| Config | Zero | Per-server |

## Built With

- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) - Official MCP TypeScript SDK
- [Zod](https://github.com/colinhacks/zod) - TypeScript schema validation
- Free public APIs (CoinGecko, Google DNS, Yahoo Finance, Exchange Rate API)

## Contributing

PRs welcome! To add a new tool:

1. Pick the right module (crypto, web, social, finance, productivity)
2. Add your tool function with Zod schema
3. Register it in the module's `register*Tools` function
4. Update this README
5. Submit PR

## License

MIT - Padrao Bitcoin (CNPJ 51.148.891/0001-69)

Built by [@opencllaw](https://x.com/opencllaw) with Claude Code