Hercules

Creates a new Hercules Agent in the organization. A Hercules Agent is a reusable AI worker owned by the organization, with its own instructions, model, and tools. Anyone on the team can chat with it. Agents are separate from Hercules Apps: an app is a web app Hercules builds, an agent is an AI worker that does work. This tool only creates the agent. Schedules, webhooks, connectors, and chat channels are set up from the agent's page in the Hercules dashboard, linked in the response.

agent_create

Lists the organization's Hercules Agents with their configuration and run activity. Call this before agent_create to check whether an agent for the job already exists.

agent_list

Creates a new Hercules App from scratch. **What is Hercules?** Hercules is an AI app builder. We make it easy for anyone to build apps and websites by chatting with AI. We specialize in building large, production-ready, full stack web applications like SaaS, Internal Tools, eCommerce sites, mobile apps, marketing pages, landing pages, SEO pages, and more. You can build 100s of apps at the same time with Hercules. Hercules apps can confidently scale to millions of users, page views, and revenue. **How does Hercules work?** Hercules does not require any technical skills to build apps. Give Hercules natural language instructions for what you want to build. Hercules will then follow these instructions, build the app, connect it to a domain, and publish (if requested). Everything you need is built into Hercules including backend, database, hosting, users/auth, domains, payments/commerce, email sending, 3rd-party app connectors, files and media CDN, analytics, version control, security, AI, and more. No API keys are required! **How do I interact with Hercules?** Give Hercules your product, feature, functionality, UX/UI requirements and any other relevant content or inspiration. Hercules will then choose the optimal engineering implementation path to accurately meet your specifications. **How does the app creation tool work?** This tool will return the URL to the Hercules App Builder where the user can continue building the app, the URL of the published app, the agentWorkflowId of the message sent, and a non-interactive screenshot preview of the app. To edit an existing app, use the message_send tool instead.

app_create

Lists the user's Hercules apps. For full details about a single app, call app_read instead.

app_list

Reads details for a specific Hercules app by name, slug, or app ID. To list all apps, call app_list instead. To edit an app, call message_send instead.

app_read

Polls the status of a message sent by app_create or message_send.

message_read

Sends a message to an existing Hercules app. Used for editing, updating, or changing an existing app. Pass the same threadId on subsequent calls to continue iterating on prior changes. To create a new app, call app_create instead.

message_send

Reads organization identity, plan, remaining credits, and recent apps. For the full list of apps, call app_list.

org_read

Lists chat conversation threads for an app. Can optionally filter by thread titles. To read or search messages inside a thread, call thread_read instead.

thread_list

Reads the full conversation of a thread: every user and assistant message with its text, the assistant's reasoning, and each tool call's input and output (including file diffs), plus per-message model, credits, and token usage. Pass includeToolDetails=false for a compact transcript that omits tool inputs and outputs. Each message lists the subagent runs it spawned (child threadId, type, and model); read one with thread_read using that threadId. Searches only messages inside the provided thread when query is supplied. To search thread titles, call thread_list instead.

thread_read