🔧 AgenticForge MCP Server

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

🚀 Quick Start

# 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

# 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

# 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

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

OpenClaw

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.