# AgentForge

> AI Agent Tool Marketplace - Discover, connect, and execute API tools built for autonomous AI agents.

AgentForge is a marketplace platform where AI agents can discover, evaluate, and execute tools via REST API or MCP (Model Context Protocol). Publishers can list tools and earn revenue per call.

## For AI Agents

- Discover tools: `GET /api/tools` or `GET /api/gateway/discover?intent=your+task`
- Get tool schema: `GET /api/gateway/schema/:toolId`
- Execute tools: `POST /api/gateway/execute/:toolId`
- Check balance: `GET /api/billing/balance`
- Batch execute: `POST /api/gateway/batch` (up to 10 tools in one request)

## Authentication

Agents authenticate via API key in the `X-Agent-Key` header.
Create an account at the platform, register an agent, and receive your API key.

## MCP Server

AgentForge provides a full MCP server for Claude Desktop, Cursor, and other MCP-compatible clients.

- **STDIO transport**: `npx tsx server/src/mcp-server.ts`
- **HTTP transport**: `POST /mcp`
- 6 tools: discover, execute, get_schema, balance, list_categories, batch_execute
- 5 resources: tool catalog, tool details, system health, call history, categories
- 3 prompts: recommend_tools, compare_tools, debug_error

## Available Tools (14 Built-in)

### Free Tools
- Text Statistics - Analyze text: word count, reading time, character frequency
- Hash Generator - Generate MD5, SHA1, SHA256, SHA512 hashes
- JSON Validator - Validate JSON and return structure info
- UUID Generator - Generate cryptographically secure UUID v4 (batch up to 50)
- Base64 Encoder/Decoder - Encode/decode Base64 with UTF-8 support
- URL Slug Generator - Convert text to URL-safe slugs with Unicode support
- DNS Lookup - Resolve A, AAAA, MX, TXT, NS, CNAME records for any domain
- Text Diff - Compare two texts and show line-by-line differences
- Random Data Generator - Generate fake test data (person, address, company, etc.)

### Premium Tools
- Sentiment Analysis - Classify text as positive/negative/neutral ($0.001/call)
- Lorem Ipsum Generator - Generate placeholder text ($0.0005/call)
- Web Scraper - Fetch URLs and extract content as text/markdown/HTML ($0.002/call)
- Code Runner - Execute JavaScript in a secure sandbox ($0.005/call)
- Weather - Current weather + 3-day forecast by coordinates ($0.001/call)

## Pricing

- Free tools: no charge
- Paid tools: per-call pricing (as low as $0.0005/call)
- New agents receive $1.00 free trial credit

## Links

- API Reference: /api-docs
- SDK Documentation: /docs
- OpenAPI Spec: /api/openapi.json
- AI Plugin Manifest: /.well-known/ai-plugin.json
- MCP Server: /mcp

## SDKs

- TypeScript: `npm install @agentforge/sdk`
- Python: `pip install agentforge-sdk`

## Full Documentation

See [llms-full.txt](/llms-full.txt) for complete API documentation with request/response examples.