Valyu Create Task
valyu_create_taskReference for creating a new deep research task via POST /v1/deepresearch/tasks.
When to Use
Use this tool when you need to reference for creating a new deep research task via post /v1/deepresearch/tasks.. This is part of the Valyu API provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 12+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
How to Execute
Use the xpay✦ meta-tools to run this tool:
xpay_details— Get full input schema:xpay_details("valyu/valyu_create_task")xpay_run— Execute:xpay_run("valyu/valyu_create_task", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mcp_servers | array | No | MCP server configurations for custom tools (max 5 servers) |
metadata | object | No | Custom metadata for tracking |
webhook_url | string | No | HTTPS URL for webhook notifications. When provided, Valyu will POST the full task result to this URL when the task completes or fails. The request includes X-Webhook-Signature and X-Webhook-Timestamp headers for verification. HTTP URLs are rejected—only HTTPS is supported. |
output_formats | string | No | Output formats. Use ['markdown'], ['markdown', 'pdf'], or a JSON schema object for structured output. Cannot mix JSON schema with markdown/pdf. |
query | string | Yes | Research query or task description |
code_execution | boolean | No | Enable/disable code execution during research |
deliverables | array | No | Additional file outputs to generate from the research (CSV, Excel, PowerPoint, Word, PDF). Max 10 deliverables. |
mode | string | No | DeepResearch mode: fast: Ideal for quicker answers and lightweight research. Typically completes in ~2–5 minutes. standard: A balanced option for deeper insights without long wait times. Runs for ~10–20 minutes. heavy: Designed for in-depth, long-running research tasks. Can run for up to ~90 minutes. |
search | object | No | Search configuration parameters |
urls | array | No | URLs to extract content from (max 10) |
files | array | No | File attachments (PDFs, images, documents). Max 10 files. |
previous_reports | array | No | Previous deep research IDs to use as context (max 3) |
model | string | No | DeepResearch mode (deprecated, use 'mode' instead) |
strategy | string | No | Natural language strategy instructions prepended to the system prompt |
Pricing
- Cost: $0.02/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Valyu API (all tools) — 13 tools
- Valyu Search — $0.02/call
- Valyu Create Batch — $0.02/call
- Valyu Get Status — $0.02/call
- Valyu Update Task — $0.02/call
- Valyu Cancel Task — $0.02/call
Links
- Tool page: https://xpay.tools/valyu/valyu-create-task/
- Provider: https://xpay.tools/valyu/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mcp_servers | array | No | MCP server configurations for custom tools (max 5 servers) |
metadata | object | No | Custom metadata for tracking |
webhook_url | string | No | HTTPS URL for webhook notifications. When provided, Valyu will POST the full task result to this URL when the task completes or fails. The request includes X-Webhook-Signature and X-Webhook-Timestamp headers for verification. HTTP URLs are rejected—only HTTPS is supported. |
output_formats | string | No | Output formats. Use ['markdown'], ['markdown', 'pdf'], or a JSON schema object for structured output. Cannot mix JSON schema with markdown/pdf. |
query | string | Yes | Research query or task description |
code_execution | boolean | No | Enable/disable code execution during research |
deliverables | array | No | Additional file outputs to generate from the research (CSV, Excel, PowerPoint, Word, PDF). Max 10 deliverables. |
mode | string | No | DeepResearch mode: fast: Ideal for quicker answers and lightweight research. Typically completes in ~2–5 minutes. standard: A balanced option for deeper insights without long wait times. Runs for ~10–20 minutes. heavy: Designed for in-depth, long-running research tasks. Can run for up to ~90 minutes. |
search | object | No | Search configuration parameters |
urls | array | No | URLs to extract content from (max 10) |
files | array | No | File attachments (PDFs, images, documents). Max 10 files. |
previous_reports | array | No | Previous deep research IDs to use as context (max 3) |
model | string | No | DeepResearch mode (deprecated, use 'mode' instead) |
strategy | string | No | Natural language strategy instructions prepended to the system prompt |
Install Skill
Pricing
Cost
$0.02/call
Model
Flat rate
Provider
Valyu API