Hercules MCP - Hercules

The Hercules MCP lets you use Hercules from ChatGPT, Claude, Cursor, Codex, and other AI assistants. In ChatGPT, connect from the Apps directory. In other assistants, add https://hercules.app/mcp as a custom MCP server.

 https://hercules.app/mcp

Hercules MCP setup with the server URL and tabs for Claude, Codex, Cursor, ChatGPT, and other AI assistants

What can I do with the Hercules MCP?

The Hercules MCP lets you do almost everything you can do from inside the Hercules App Builder. You can

Capability	What it does
Create apps	Build a new Hercules app or website from a description.
Edit apps	Send instructions to Hercules to change an existing app.
Publish apps	Publish an app and get its Published URL back.
List and read apps	Browse your apps and read details: title, description, slug, Published URL.
Browse conversations	List and read the chat threads behind each app, with search.
Check your org	See your organization, plan, remaining credits, and recent apps.

What are some example prompts?

Build a new app

Build a CRM for my roofing company to track leads, quotes, and scheduled jobs, then publish it in Hercules.

Edit an existing app

Open my "Sales CRM" Hercules app and add a pipeline view grouped by deal stage.

How do I set it up?

Copy the server URL into your assistant, then sign in. The first tool call prompts you to connect. In ChatGPT, open the Hercules app page and click Connect instead.

ChatGPT
Claude
Cursor
VS Code
Codex

Hercules is live in the ChatGPT Apps directory.

Hercules app listing in ChatGPT with example prompts to build an ERP, a mobile app, and neighborhood websites

Open Hercules in ChatGPT

Go to the Hercules app in ChatGPT, or search Hercules on chatgpt.com/apps.

Connect

Click Connect, then sign in with Hercules and pick your organization.

Start building

Ask ChatGPT to create or edit an App. Your work shows up in the Hercules App Builder.

Need a custom MCP connector instead? Turn on developer mode under Settings → Connectors, choose Create, and paste https://hercules.app/mcp.

Add the connector

Open Settings → Connectors and choose Add custom connector.

Paste the server URL

Enter https://hercules.app/mcp and confirm.

Prefer the command line? In Claude Code, run:

claude mcp add --transport http \
  hercules https://hercules.app/mcp

Open MCP settings

Go to Cursor Settings → MCP → Add new server.

Add the Hercules entry

Add the following to ~/.cursor/mcp.json:

~/.cursor/mcp.json

{
  "mcpServers": {
    "hercules": { "url": "https://hercules.app/mcp" }
  }
}

Reload and authorize

Reload Cursor, then finish the sign-in prompt.

Add the server

Run MCP: Add Server from the Command Palette, pick HTTP, and paste the URL. Or edit .vscode/mcp.json directly:

.vscode/mcp.json

{
  "servers": {
    "hercules": {
      "type": "http",
      "url": "https://hercules.app/mcp"
    }
  }
}

Start and sign in

Start the server and sign in with Hercules.

Edit your config

Open ~/.codex/config.toml and add the Hercules server entry:

~/.codex/config.toml

[mcp_servers.hercules]
url = "https://hercules.app/mcp"

Restart and authorize

Restart Codex and authorize with Hercules.

Using a client that isn’t listed? Any MCP client that supports a remote HTTP server with OAuth works. Point it at https://hercules.app/mcp and follow your client’s steps for adding a remote MCP server.

Additional FAQ

Which assistants and clients are supported?

Hercules is published in the ChatGPT Apps directory. Any MCP client that supports a remote, OAuth-secured HTTP server can also connect with https://hercules.app/mcp. Setup is documented above for ChatGPT, Claude (Desktop and Claude Code), Cursor, VS Code, and Codex.

Do I need an API key?

No. Sign-in happens through OAuth in your browser. There are no keys to generate, copy, or rotate.

Is it safe? What can my assistant access?

The connection is scoped to the single organization you pick during sign-in, and limited to managing your Hercules apps and their conversations. You approve the access when you sign in, and you can disconnect it at any time from your client.

How do I connect a different organization?

Disconnect the Hercules connector in your client, then add it again. On the next sign-in, choose the organization you want. Each connection is tied to one organization.

What does it cost?

Connecting the MCP server is free. Building and editing apps uses the AI credits of the organization you connected, the same as building in the Hercules App Builder. See AI Credits for details.

Can I keep working in the Hercules App Builder too?

Yes. The MCP server is another way in. Apps you create or edit from your assistant appear in the Hercules App Builder, and changes you make in the Hercules App Builder are visible to your assistant.

My assistant isn't picking up the Hercules tools.

Reload or restart your client after adding the server, and make sure you finished signing in. The tools become available once the connection is authorized. Check that the URL is exactly https://hercules.app/mcp.

What happens if a build takes a while?

Creating or editing an app starts a build with Hercules. Your assistant tracks progress and shares the Published URL once the build finishes. Larger apps take longer, the same as in the Hercules App Builder.

​What can I do with the Hercules MCP?

​What are some example prompts?

​How do I set it up?

​Additional FAQ

What can I do with the Hercules MCP?

What are some example prompts?

How do I set it up?

Additional FAQ