# 🔧 AgenticForge MCP Server

A monetizable MCP server with 8 useful AI agent tools. Deploy once, earn forever.

[![MCP](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-yellow.svg)](https://python.org)

## 🚀 Quick Start

```bash
# Clone
git clone https://github.com/YOUR_USERNAME/agenticforge-mcp.git
cd agenticforge-mcp

# Install
pip install -r requirements.txt

# Run
python server.py
# → http://localhost:8765
```

## 🛠 Tools

| Tool | Description | Use Case |
|------|-------------|----------|
| `parse_document` | Parse PDF/HTML/Markdown → clean text | Document processing |
| `analyze_text` | Keywords, sentiment, word stats | Content analysis |
| `convert_format` | JSON ↔ CSV ↔ YAML ↔ TOML | Data engineering |
| `generate_code` | FastAPI/Flask/Express/Docker/K8s | Scaffolding |
| `security_scan` | Detect secrets, injection, XSS | Code security |
| `summarize` | Extractive text summarization | Content curation |
| `regex_extract` | Extract emails, phones, URLs | Data extraction |
| `json_transform` | Flatten, merge, filter JSON | Data transformation |

## 📡 API Usage

### REST API

```bash
# List tools
curl https://aiagent.skin/forge/tools

# Call a tool
curl -X POST https://aiagent.skin/forge/tools/analyze_text \
  -H "Content-Type: application/json" \
  -d '{"text": "Your text here"}'

# With API key (premium)
curl -X POST https://aiagent.skin/forge/tools/security_scan \
  -H "Content-Type: application/json" \
  -H "X-API-Key: af_your_key_here" \
  -d '{"code": "your_code_here"}'
```

### MCP Protocol

```bash
# Initialize
curl -X POST https://aiagent.skin/forge/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

# List tools
curl -X POST https://aiagent.skin/forge/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call tool
curl -X POST https://aiagent.skin/forge/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"summarize","arguments":{"text":"Long text...","max_words":50}}}'
```

## 💰 Pricing

| Tier | Requests/Day | Price |
|------|-------------|-------|
| Anonymous | 10 | Free |
| Free | 50 | Free (register) |
| Premium | 1,000 | $5/month |

## 🔌 MCP Client Integration

### Claude Desktop

```json
{
  "mcpServers": {
    "agenticforge": {
      "url": "https://aiagent.skin/forge/mcp"
    }
  }
}
```

### OpenClaw

```yaml
skills:
  entries:
    agenticforge:
      enabled: true
```

## 🏗 Architecture

```
┌─────────────────────────────────────────┐
│            Nginx (HTTPS)                │
│         aiagent.skin/forge/             │
└─────────────┬───────────────────────────┘
              │
┌─────────────▼───────────────────────────┐
│        FastAPI MCP Server               │
│    ┌──────────────────────────┐         │
│    │  8 Tools + MCP Protocol  │         │
│    │  + Billing System        │         │
│    └──────────────────────────┘         │
│    Port: 8765                           │
└─────────────────────────────────────────┘
```

## 📜 License

MIT License - use it however you want.

## 🤝 Contributing

PRs welcome! Open an issue first to discuss changes.