MCP Quickstart

Connect API-backed tools only to any MCP client. Website-only tools are not exposed.

Endpoint

https://api.toolyour.com/mcp

Authentication

Use the same API key as REST:

X-Api-Key: ty_your_key_here

Create keys in the ToolYour dashboard.

Cursor / Claude config

{
  "mcpServers": {
    "toolyour": {
      "url": "https://api.toolyour.com/mcp",
      "headers": {
        "X-Api-Key": "ty_YOUR_KEY"
      }
    }
  }
}

Agent workflow

Recommended: use solve_task(goal) — describe what the user wants in plain language. The server picks the right workflow or tool, extracts URLs from the goal, and runs it. Suggestions are free; execution bills like invoke_tool.

Example goal: SEO audit for https://example.com

When solve_task does not auto-match

The response has status: "suggest" with:

• toolSuggestions — up to 5 tools already searched from your goal text
• taskSuggestions — related curated tasks

Pick a toolSuggestions entry, call get_tool_schema(operationId), then invoke_tool. Or search manually with discover_tools.

Search tools manually

1. list_categories() — tool families (Convertors, Documents, SEO Tools, …)
2. discover_tools(query, category?) — search by keyword (free, not billed). Use specific queries: docx pdf, webp convert, headline rewrite
3. get_tool_schema(operationId) — load schema for one tool (free)
4. invoke_tool(operationId, input) — run tool (counts toward monthly quota)

Other optional tools:

• load_skill(skillId) — playbook for multi-step goals
• run_workflow(workflowId, input) — server-side pipeline (bills per step)

File outputs

Conversion tools return JSON with downloadUrl (presigned, 1 hour). Pass the URL to users or downstream tools — do not expect raw bytes in MCP responses.

Quota

MCP solve_task, invoke_tool, and workflow steps share your account quota with REST. Meta-tools (solve_task suggestions, discover_tools, get_tool_schema, list_skills) are free when no tool runs.

See Usage & plans and MCP discovery.