MCP Server

Native integration with Claude, Cursor, and other AI tools via Model Context Protocol.

Installation

Install the AutoManus MCP server using npx:

npx -y @automanus/mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "automanus": {
      "command": "npx",
      "args": ["-y", "@automanus/mcp-server"]
    }
  }
}

No email needed in config - Claude will ask for your email when creating an agent.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "automanus": {
      "command": "npx",
      "args": ["-y", "@automanus/mcp-server"]
    }
  }
}

Environment Variables (Optional)

These are optional. If not set, Claude will ask for your email when creating an agent.

VariableRequiredDescription
AUTOMANUS_EMAILNoDefault email. If not set, Claude will ask you.
AUTOMANUS_API_KEYNoAPI key for existing users. Agents created under your account.

With an API key, agents are created directly under your account without needing to claim them.

Available Tools

create_sales_agent

Create an AI sales agent for a business. Researches the website automatically.

Parameters:

  • email (required) - Email for account association
  • company_name (required) - Business name
  • website_url (optional) - Website to research

add_knowledge

Add a knowledge base item to an existing agent.

Parameters:

  • agent_id (required) - Agent UUID
  • title (required) - Item title
  • content (required) - Item content
  • item_type (optional) - product, faq, or policy

get_agent_status

Get status of an agent including deployment info and KB count.

Parameters:

  • agent_id (required) - Agent UUID

Usage Examples

In Claude Desktop

After configuring, you can say:

"Create an AI sales agent for my company TechStartup. Our website is techstartup.com"

In Cursor

When building an app, you can say:

"Add an AI sales chat to this app. Use AutoManus to create an agent based on the README and add the webchat widget to the homepage."

User Flow

New Users (email not registered)

  1. MCP tool creates demo agent
  2. Magic link email sent with webchat code and WhatsApp link
  3. Agent works immediately with 100 free credits
  4. Click claim link to signup and take ownership

Existing Users (with API key)

  1. MCP tool creates agent under your account
  2. Agent immediately appears in your dashboard
  3. Credits deducted from your subscription

Troubleshooting

Tools not appearing

Restart Claude Desktop or Cursor after updating mcp.json. Check that npx is in your PATH.

Rate limit errors

Maximum 10 agents per email per day. Use an API key for higher limits.

Website research failing

Some websites block scraping. Use codebase_context parameter to provide content directly.