Hercules MCP - Hercules

The Hercules MCP lets you use Hercules from other AI assistants like ChatGPT, Claude, Cursor, and Codex.

 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.

Claude
ChatGPT
Cursor
VS Code
Codex

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

Enable developer mode

Open Settings → Connectors and turn on developer mode.

Create the connector

Choose Create, then paste https://hercules.app/mcp.

Authorize

Authorize with Hercules and pick your organization.

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?

Any MCP client that supports a remote, OAuth-secured HTTP server. Setup is documented above for Claude (Desktop and Claude Code), ChatGPT, Cursor, VS Code, and Codex. The same URL works in other MCP clients too.

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