# Manus — how to use (mcp.ai)

Connect your Manus account and use 14 tools for productivity straight from your AI agent. Connect with your own API key. AI-powered task automation and workflow management platform.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_manus?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `manus_create_file`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/manus`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/manus/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/manus/create/file` — Tool to create a file record and obtain a presigned URL for uploading file content to S3. Use when you need to upload a file to Manus. After calling this action, use the returned upload_url with a PUT
  - body: { filename: string }
- `POST https://api.mcp.ai/api/manus/create/project` — Tool to create a new project with default instructions. Projects organize tasks and apply consistent instructions across multiple task creations via the project_id parameter. Use when you need to set 
  - body: { name: string, instruction?: string }
- `POST https://api.mcp.ai/api/manus/create/task` — Creates a new AI task with custom parameters, attachments, and optional connectors. Supports multi-turn conversations by specifying taskId for continuation. Use when you want to create a new task for 
  - body: { locale?: string, prompt: string, task_id?: string, task_mode?: string, connectors?: string[], project_id?: string, attachments?: object[], agent_profile: string, interactive_mode?: boolean, hide_in_task_list?: boolean, create_shareable_link?: boolean }
- `POST https://api.mcp.ai/api/manus/create/webhook` — Tool to register a webhook to receive real-time task notifications. Use when you need to set up real-time notifications for task events such as task_created, task_progress, and task_stopped. The webho
  - body: { url: string }
- `POST https://api.mcp.ai/api/manus/delete/file` — Deletes a file by ID. This removes both the file record and the file from S3 storage. Use when you need to remove a previously uploaded file from the Manus platform.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/manus/delete/task` — Permanently delete a task by its ID. This action cannot be undone. Use this action when you want to permanently remove a task from the system.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/manus/delete/webhook` — Removes a webhook subscription. This is a destructive operation that permanently removes the webhook. Use when you need to delete an existing webhook that is no longer needed.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/manus/get/file` — Retrieves details of a specific file by ID, including its status and metadata. Use this to get information about a previously uploaded file such as its name, current status (pending, uploaded, or dele
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/manus/get/task` — Retrieves details of a specific task by ID, including status, output messages, credit usage, and metadata. Use this action to check the current status of a task and retrieve its results after it has b
  - body: { convert?: boolean, task_id: string }
- `POST https://api.mcp.ai/api/manus/get/webhook/public/key` — Retrieves the RSA public key used for verifying webhook signatures. Use this key to validate that webhook requests genuinely came from Manus. This is essential for security - always verify webhook sig
- `POST https://api.mcp.ai/api/manus/list/files` — Retrieves a list of the 10 most recently uploaded files. Use this action to get information about files that have been uploaded to the Manus platform, including their IDs, filenames, creation timestam
- `POST https://api.mcp.ai/api/manus/list/projects` — Retrieve a list of all projects in your account with optional pagination. Use this action when you need to get all projects to find a specific project ID or to see all available projects.
  - body: { limit?: integer }
- `POST https://api.mcp.ai/api/manus/list/tasks` — Retrieves a list of tasks with optional filtering and pagination. Allows searching, filtering by status, and sorting by creation or update time. Use this action to fetch multiple tasks at once, option
  - body: { after?: string, limit?: integer, order?: string, query?: string, status?: string[], order_by?: string, project_id?: string, created_after?: integer, created_before?: integer }
- `POST https://api.mcp.ai/api/manus/update/task` — Updates a task's metadata such as title, sharing settings, and visibility in the task list. Use when you need to modify an existing task's properties like its title, enable or disable public sharing, 
  - body: { title?: string, task_id: string, enableShared?: boolean, enableVisibleInTaskList?: boolean }

## Example prompts
- "What can I do in Manus?"
- "Show me a summary of my Manus account"

## More
- Page: https://mcp.ai/manus
- Agent spec (llms.txt): https://mcp.ai/manus/llms.txt
- Postman collection: https://mcp.ai/manus/postman.json