Skip to content

doggychip/agentforge

Repository files navigation

AgentForge

One API key. 300+ AI agents. Zero configuration.

AgentForge is a unified API gateway and marketplace for AI agents. Use a single API key to access hundreds of AI agents — no need to manage individual API keys, authentication, or billing for each one.

Live Demo | API Docs | Browse Agents

Why AgentForge?

Most AI agent platforms make you manage separate API keys, auth flows, and billing for every agent you use. AgentForge gives you one key to rule them all.

  • Unified API — Call any agent through a single REST endpoint
    • 300+ agents — Pre-loaded with trending agents from GitHub and HuggingFace
      • Creator economy — Publish your own agents and earn revenue (90% creator share)
        • Built for developers — RESTful API, streaming support, API key auth, rate limiting
          • MCP support — Use AgentForge as a Model Context Protocol server to access all agents from Claude, Cursor, and other MCP clients

          • Quick Start

          • Use the API (no install needed)

          • # 1. Get your API key at https://patreon.zeabur.app/#/settings/api-keys
            # 2. Call any agent:
            curl -X POST https://patreon.zeabur.app/api/agents/AGENT_ID/invoke \
              -H "Authorization: Bearer af_k_your_key_here" \
              -H "Content-Type: application/json" \
              -d '{"messages": [{"role": "user", "content": "Hello!"}]}'

            Python

            import requests
            response = requests.post(
                "https://patreon.zeabur.app/api/agents/AGENT_ID/invoke",
                headers={"Authorization": "Bearer af_k_your_key_here"},
                json={"messages": [{"role": "user", "content": "Hello!"}]}
            )
            print(response.json())

            JavaScript

            const response = await fetch(
              "https://patreon.zeabur.app/api/agents/AGENT_ID/invoke",
              {
                method: "POST",
                headers: {
                  "Authorization": "Bearer af_k_your_key_here",
                  "Content-Type": "application/json",
                },
                body: JSON.stringify({
                  messages: [{ role: "user", content: "Hello!" }],
                }),
              }
            );
            const data = await response.json();

            MCP Server (Model Context Protocol)

            AgentForge ships a built-in MCP server (mcp/server.ts) that exposes all 300+ agents as MCP tools. This lets any MCP-compatible client — Claude Desktop, Cursor, Continue, etc. — discover and invoke agents with zero extra configuration.

            MCP Tools exposed

            Tool Description
            list_agents List all agents on the marketplace (optional category/limit filter)
            get_agent Get full details for a specific agent by ID
            invoke_agent Invoke any agent with a chat-completion style messages array
            check_agent_health Check the health/availability of a specific agent
            get_platform_stats Retrieve aggregate platform statistics

            Running the MCP server locally

            git clone https://github.com/doggychip/agentforge.git
            cd agentforge
            npm install
            
            # Set your AgentForge API key (get one at https://patreon.zeabur.app/#/settings/api-keys)
            export AGENTFORGE_API_KEY=af_k_your_key_here
            
            # Start the MCP server (communicates over stdio)
            npm run mcp:start

            Connecting to Claude Desktop

            Add the following to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

            {
              "mcpServers": {
                "agentforge": {
                  "command": "npx",
                  "args": ["tsx", "/path/to/agentforge/mcp/server.ts"],
                  "env": {
                    "AGENTFORGE_API_KEY": "af_k_your_key_here"
                  }
                }
              }
            }

            Restart Claude Desktop. You will now see AgentForge tools available in the MCP connector panel.

            Connecting to other MCP clients

            Any MCP client that supports stdio transport can connect to AgentForge:

            # Generic stdio invocation
            AGENTFORGE_API_KEY=af_k_your_key_here npx tsx /path/to/agentforge/mcp/server.ts

            Environment variables for the MCP server

            Variable Required Description
            AGENTFORGE_API_KEY Yes (for invoke_agent) Your AgentForge API key
            AGENTFORGE_BASE_URL No Override base URL (default: https://patreon.zeabur.app)

            Features

            For Users

            • Browse and discover 300+ AI agents, tools, and APIs
              • One API key to access all agents
                • Free and paid agents with transparent pricing
                  • Streaming support for real-time responses
                    • Usage tracking and billing history

                    • For Creators

                    • Publish unlimited agents with your own pricing
                    • 90% revenue share (10% platform fee)
                    • Stripe Connect payouts to your bank account
                    • Analytics dashboard with subscriber metrics
                    • API proxy — we handle auth, rate limiting, and billing

                    • Platform

                    • Google OAuth + email/password authentication
                    • Two-factor authentication (TOTP)
                    • Rate limiting (1000 req/hour, 10000 req/day per key)
                    • Agent health monitoring
                    • Auto-import from GitHub trending and HuggingFace

                    • API Endpoints

                    • | Method | Endpoint | Description |

                    • |--------|----------|-------------|

                    • | POST | /api/agents/:id/invoke | Invoke an agent |

                    • | GET | /api/agents | List all agents |

                    • | GET | /api/agents/:id | Get agent details |

                    • | GET | /api/agents/:id/health | Check agent health |

                    • | GET | /api/stats | Platform statistics |

                    • Full API documentation: patreon.zeabur.app/#/docs

                    • Self-Hosting

                    • Prerequisites

                    • Node.js 20+
                    • PostgreSQL

                    • Setup

                    • git clone https://github.com/doggychip/agentforge.git
                      cd agentforge
                      npm install
                      
                      # Set environment variables
                      export DATABASE_URL=postgresql://user:password@host:5432/agentforge
                      
                      # Start development server (auto-migrates and seeds)
                      npm run dev

                      Environment Variables

                      Variable Required Description
                      DATABASE_URL Yes PostgreSQL connection string
                      STRIPE_SECRET_KEY No Stripe API key for payments
                      STRIPE_WEBHOOK_SECRET No Stripe webhook signing secret
                      GOOGLE_CLIENT_ID No Google OAuth client ID
                      GOOGLE_CLIENT_SECRET No Google OAuth client secret
                      SMTP_HOST No SMTP server for emails
                      SMTP_USER No SMTP username
                      SMTP_PASS No SMTP password

                      Deploy to Zeabur

                      1. Push to GitHub
                        1. Create project in Zeabur
                          1. Import the repo + add PostgreSQL service
                            1. Zeabur auto-injects DATABASE_URL

                            2. Tech Stack

                            3. Frontend: React 18, Tailwind CSS, shadcn/ui, TanStack Query, wouter
                            4. Backend: Express 5, Drizzle ORM, Passport
                            5. Database: PostgreSQL
                            6. Payments: Stripe Connect
                            7. Auth: bcrypt, Google OAuth, TOTP 2FA
                            8. Deploy: Docker / Zeabur
                            9. MCP: @modelcontextprotocol/sdk (TypeScript)

                            10. Project Structure

                            11. agentforge/
                              ├── client/src/          # React frontend
                              │   ├── pages/           # Route pages
                              │   ├── components/      # Shared components
                              │   └── hooks/           # Auth, query hooks
                              ├── mcp/
                              │   └── server.ts        # MCP server (5 tools over stdio)
                              ├── server/
                              │   ├── routes.ts        # API endpoints
                              │   ├── storage.ts       # Database layer
                              │   └── db.ts            # Connection + migrations
                              ├── shared/
                              │   └── schema.ts        # Drizzle schema + types
                              └── Dockerfile
                              

                              Contributing

                              Pull requests welcome. For major changes, open an issue first.

                              License

                              MIT

About

AgentForge — subscription marketplace for AI agents, tools & content. Built for developers and AI agents alike.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages