Hercules MCP

Use the Hercules MCP (Model Context Protocol, the standard that lets AI assistants use outside tools) to create, build, and manage Hercules apps from any AI assistant (like ChatGPT, Claude, Cursor etc). Use our MCP URL below to get started.

The server URL is:

https://hercules.app/mcp

What can I do with it?

Once connected, your assistant can use these Hercules tools on your behalf:

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.
List and read apps	Browse your apps and read details: title, description, slug, live 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.

You chat normally. Your assistant picks the right tool based on what you ask. For example:

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.

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.

Open MCP settings

Go to Windsurf Settings → Cascade → MCP servers.

Add the Hercules entry

Add the following to your mcp_config.json:

mcp_config.json

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

Refresh and authorize

Refresh, then complete the sign-in prompt.

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, Codex, and Windsurf. 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 Dashboard. See AI Credits for details.

Can I keep working in the Dashboard too?

Yes. The MCP server is another way in. Apps you create or edit from your assistant appear in the Hercules Dashboard, and changes you make in the Dashboard 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 live URL once the build finishes. Larger apps take longer, the same as in the Dashboard.

Need help? Reach us at hello@hercules.app.

Get Started

Hercules AI Agent

Build your app

Publish your app

Developer

Platform Admin

Company

What can I do with it?

How do I set it up?

Additional FAQ

Get Started

Hercules AI Agent

Build your app

Publish your app

Developer

Platform Admin

Company

Documentation Index

​What can I do with it?

​How do I set it up?

​Additional FAQ

What can I do with it?

How do I set it up?

Additional FAQ