AgentTasker MCP Server
AgentTasker MCP server lets you run single tasks or parallel batches for web search, website reading, HTTP requests, Python code, shell commands, file I/O, and remote MCP tool calls.
Run one task with
executeusing parameters liketask_type,url,query,code,command,path, etc.Run many tasks in parallel with
execute_batch, optionally usingdepends_onfor task ordering andoutput_mode(compact/full).Task types include:
python_code,http_request,discovery_search,web_scrape,shell_command,file_read,file_write.Search the web via Brave or SearXNG, scrape/read webpages (Markdown preferred, HTML fallback, optional Jina fallback).
Make HTTP requests with method, headers, body, retries, timeout, and SSL verification control.
Execute Python code and shell commands.
Read/write files with path, content, and mode (
w/a).Manage background batches (poll/cancel via
get_batch/cancel_batchper README) and get ordered results.Call other MCP tools through a configured
servers.json(own stdio connections, no caching/retries for remote tools).Built-in caching, rate limiting, compact results, and concurrency limit (default 10).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AgentTasker MCP Serverrun Python code and an HTTP request in parallel"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AgentTasker MCP
Search the web, read websites, and run MCP tools in parallel.
Run ten searches or five calls to another MCP tool in one batch. Your agent picks concurrency up to your limit (default: 10). Background batches, search caching, rate limiting, and compact results are built in.
Python 3.10+. Zero third-party runtime dependencies. Local stdio MCP transport.
Quick start
1. Install uv and Git. uv includes uvx, which installs the server on first use. No clone needed.
2. Add AgentTasker to your coding app. Pick one option below.
Claude Code
claude mcp add --scope user --transport stdio agent-tasker -- uvx --from git+https://github.com/S3bRR/agent-tasker-mcp.git agent-tasker-mcp-serverCodex CLI / IDE extension
codex mcp add agent-tasker -- uvx --from git+https://github.com/S3bRR/agent-tasker-mcp.git agent-tasker-mcp-serverCursor / Claude Desktop / other JSON-based clients
Create your MCP config with this JSON, or merge the entry into an existing file. Cursor uses ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Claude Desktop: Settings → Developer → Edit Config.
{
"mcpServers": {
"agent-tasker": {
"command": "uvx",
"args": ["--from", "git+https://github.com/S3bRR/agent-tasker-mcp.git", "agent-tasker-mcp-server"]
}
}
}For Cursor, also add "type": "stdio" inside the agent-tasker entry.
VS Code / Copilot: copy-ready config. OpenCode: copy-ready config.
3. Restart your app and approve/enable AgentTasker if prompted. Ask:
Use AgentTasker to read https://example.com and tell me its title.
This needs no API key or search setup. You should see five tools: execute, execute_batch, get_batch, cancel_batch, and list_remote_tools.
GUI app cannot find
uvx? Setcommandto its full path (command -v uvxon macOS/Linux,where.exe uvxon Windows). First launch needs network access; increase your client's startup timeout if necessary.
Related MCP server: local-mcp
Enable search or other MCP tools
Fetch webpages: works immediately, without an API key. Try:
Use AgentTasker to fetch these five URLs in parallel and summarize them. Use a background batch if it might take a while.
Web search: append --search-provider brave to the server arguments and set BRAVE_SEARCH_API_KEY in its environment. Or use --search-provider searxng --searxng-url http://localhost:8080 with a running SearXNG instance that enables JSON. No provider file needed. Copy-ready search setup →
Difficult websites: Markdown is preferred, with local HTML extraction otherwise. Opt in to --reader-fallback jina for hosted rendering fallback on public pages; it shares URLs with Jina and is off by default. Website reading, privacy, and curl examples →
Use AgentTasker to run ten different searches about Python asyncio with concurrency 10, in the background. Poll for results and give me a concise summary.
Other MCP tools: append --mcp-config /absolute/path/to/servers.json. Start from this example, then ask:
Use AgentTasker to call the fetch server's fetch tool for five URLs with concurrency 5.
AgentTasker starts its own configured stdio connections; it cannot reuse your harness's existing MCP sessions. Remote tools are not cached or retried because they may have side effects. Provider quotas still apply; search presets default to one request/second.
Prefer a local install?
On macOS/Linux, with Python 3.10+:
git clone https://github.com/S3bRR/agent-tasker-mcp.git
cd agent-tasker-mcp
./setup.sh --client cursorReplace cursor with claude, codex, vscode, opencode, or generic. Paste the printed config into your app's config file, then restart the app. The installer never overwrites your settings. Keep the checkout/virtual environment in place.
# Include search or other MCP servers in the generated config:
./setup.sh --client codex --search-provider brave --mcp-config /absolute/path/to/servers.json
# Regenerate config later, without reinstalling:
.venv/bin/agent-tasker-mcp-server --print-config vscodeWindows installation and full harness setup →
Reference
Only connect servers you trust. Cancelling a batch skips queued work; already-running calls may finish. Background jobs and caches are process-local and disappear when the server restarts.
Available Tools
2 toolsexecuteB
Run one task and return its result.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Task name | |
| task_type | Yes | Task type | |
| code | No | Python code | |
| timeout | No | Timeout seconds | |
| url | No | Target URL | |
| method | No | HTTP method | |
| headers | No | Headers | |
| body | No | Request body | |
| verify_ssl | No | Verify SSL | |
| max_body_bytes | No | Max response bytes | |
| retries | No | Retry count | |
| retry_backoff_seconds | No | Retry backoff seconds | |
| query | No | Search query | |
| providers | No | Discovery providers | |
| max_results | No | Max results | |
| fetch_top_results | No | Fetch top result pages | |
| fetch_max_chars | No | Chars per fetched page | |
| max_links | No | Max links | |
| max_text_chars | No | Max extracted chars | |
| include_html | No | Include raw HTML | |
| extract_links | No | Include links | |
| extract_headings | No | Include headings | |
| link_include_pattern | No | Regex for kept links | |
| command | No | Command | |
| path | No | File path | |
| content | No | File content | |
| mode | No | w or a | |
| output_mode | No | full or compact | compact |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, and the description adds no behavioral context beyond the basic action. It does not disclose security requirements, side effects, rate limits, or error handling, leaving a significant gap for a tool with 28 parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise (6 words) and front-loaded with the core purpose. However, for a tool with 28 parameters, slightly more detail could aid understanding without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the high parameter count and no output schema, the description is insufficiently complete. It lacks information about return values, error scenarios, and how to properly configure the many task types.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description does not add any meaning beyond the schema's parameter descriptions, which are already present.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Run one task and return its result' clearly states the action (run) and the resource (task), and implicitly distinguishes from sibling 'execute_batch' by specifying a single task.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus execute_batch, or on prerequisites, context, or exclusions. The agent must infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
execute_batchA
Run many tasks in parallel and return ordered results.
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | Task definitions | |
| output_mode | No | full or compact | compact |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden but only mentions parallelism and ordered results. It omits details on error handling, concurrency limits, side effects, or ordering guarantees. Some transparency exists but significant gaps remain.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence covering the core functionality without redundancy. It is appropriately front-loaded, though it could benefit from a brief expansion on ordering or parallelism details without sacrificing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of the tool (multiple task types, no output schema, no annotations), the description is too brief. It fails to explain ordering guarantees, error behavior, return structure, or concurrency limits, leaving the agent with insufficient context for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds no additional meaning beyond the schema for the 'tasks' and 'output_mode' parameters, which are already well-documented in the input schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool 'run[s] many tasks in parallel' and returns ordered results, distinguishing it from the sibling 'execute' tool which likely handles single tasks. The verb 'run' and resource 'tasks' are specific and unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for parallel execution of multiple tasks via the phrase 'many tasks in parallel,' which contrasts with the sibling 'execute' tool for single tasks. However, it does not explicitly state when to use this tool over alternatives or provide exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
v1.0.1- First observed
execute - First observed
execute_batch
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one executes a single task, the other executes multiple tasks in parallel. There is no overlap or ambiguity.
Both tool names follow a consistent verb_noun pattern: 'execute' and 'execute_batch'. The batch suffix clearly indicates the parallel execution variant.
With only 2 tools, the server feels minimal. While it covers the basic task execution needs, the scope of a 'Tasker' service might warrant additional tools for management (e.g., listing, canceling). The count is borderline but acceptable for a narrow focus.
The server lacks tools for task management beyond execution, such as listing tasks, checking status, canceling, or deleting. This creates significant gaps for an agent needing full task lifecycle support.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server that lets AI models invoke CLI agents (Gemini, Codex, Claude, OpenCode) as tools — with parallel execution, retries, and structured output parsing.1329 PyPI4MIT
- AlicenseNot gradedqualityDmaintenanceA lightweight, stdio-based MCP server enabling AI assistants to perform local file system operations like reading, writing, searching, and executing commands.3,904 npmMIT
- AlicenseAqualityBmaintenanceA lightweight MCP server that enables AI assistants to execute local development tools and retrieve system status with low latency over stdio or HTTP.154 npm3MIT
- AlicenseAqualityAmaintenanceMCP server that enables running and managing file-based AI Skills, Agents, and Flow workflows as DAGs, with tools for listing, executing, and resuming tasks via stdio JSON-RPC.926 PyPIMIT