ToolYour
Remote MCP server for AI agents: plan → run playbooks/solve → verify until pass. SEO, ship-gate, security, and converters on one API key shared with REST.
Documentation
Remote MCP server for Cursor and Claude
Agents plan the work, run the checks, and verify until the gate passes — on one remote MCP server. Connect at https://api.toolyour.com/mcp — same API key and monthly credit quota as REST. Only API-backed tools appear on MCP.
What is a remote MCP server?
A remote (hosted) MCP server is a Model Context Protocol endpoint the client reaches over HTTPS — a URL in mcp.json — instead of a local npx / stdio process. The official MCP connect guide covers that protocol. ToolYour is one such server: https://api.toolyour.com/mcp.
| Concern | Local MCP | ToolYour remote MCP |
|---|---|---|
| Where it runs | Your laptop (child process) | Hosted at api.toolyour.com |
| Transport | stdio | Streamable HTTP / SSE — a URL |
| Setup | Install a package per machine | Paste URL + API key |
| Auth | Local env secrets | X-Api-Key (same key as REST). Not OAuth-only. |
| Best fit | Filesystem, local scripts | SEO, ship-gate, security, API-backed converters |
This server does not replace Cursor or Claude. It does not expose every catalog page on MCP — only API-backed tools. It is not Zapier (app connectors) or GitHub MCP (repos).
Why do agents use a remote MCP server here?
Most MCP servers cover code, repos, or browsers. ToolYour is a remote MCP server with a plan → run → verify loop — ship gates, SEO audits, security checks, and related jobs from Cursor or Claude without per-tool wrappers. It does not replace your agent runtime.
-
Task-oriented
Start withplan_task(free), thenrun_playbookorsolve_task. Readloop.remainingFixes, apply them in the repo, thenverify_taskuntilloop.gateis pass.invoke_toolis only for a one-off operationId. -
Token-efficient discovery
Agents search the catalog on demand instead of loading hundreds of tool schemas upfront. -
Same plan as REST
One key, one quota for apps and agents. Free tier includes 500 credits/month.
Which job workflows does solve_task route to?
solve_task is the primary MCP entry: plain-language goals route to workflows or tools with fuzzy matching, confidence gating, and synthesized job reports. Ambiguous goals return ranked suggestions instead of a wrong run. When a goal matches, workflows return a merged jobReport with scores, findings, and prioritized actions. Discovery and suggestions without execution remain free.
full-seo-auditSEO + page-speed proxy auditcore-web-vitals-jobCore Web Vitals proxies (not CrUX/Lighthouse)full-seo-optimization-jobFull SEO optimization (6 tools)internal-link-architecture-jobInternal link architecturetechnical-seo-audit-jobTechnical SEO audit (lite)social-preview-audit-jobSocial preview (OG / Twitter)content-quality-audit-jobContent quality auditkeyword-opportunity-review-jobKeyword opportunity reviewseo-deploy-regression-jobSEO deploy regression (bulk URLs)seo-deploy-regression-diff-jobSEO staging vs production diffcrawl-readiness-jobCrawl readiness (robots, sitemap, redirects)structured-data-audit-jobStructured data audit (schema + meta)ai-overview-readiness-jobAI Overview readiness checksite-icons-audit-jobSite icons audit (favicon, apple-touch)document-convert-pipelineDocument convert pipelinefrontend-webp-jobFrontend WebP conversionfull-security-auditFull security audit (headers + TLS + cookies)security-headers-jobSecurity headers checkfrontend-supply-chain-jobFrontend supply chaindeveloper-ship-checklist-jobDeveloper ship checklistdev-json-pipeline-jobDev JSON pipelinedev-auth-debug-jobDev auth debugdev-format-transform-jobDev format transformship-gate-jobShip gate (URL smoke: headers/TLS/mixed/status/speed)secrets-hygiene-jobSecrets hygiene scanauth-token-hygiene-jobAuth token hygieneemail-auth-security-jobEmail auth + DNS + security.txtcampaign-tracking-setup-jobCampaign tracking setuppaid-ads-copy-gate-jobPaid ads copy gategrowth-unit-economics-jobGrowth unit economicsemail-campaign-qa-jobEmail campaign QAlanding-conversion-check-jobLanding conversion check
Curated skill → workflow map: MCP playbooks. Canonical agent loop: plan_task → run_playbook / solve_task → apply loop.remainingFixes → verify_task.
How do you connect Cursor, Claude, or another MCP client?
- 1
Get an API key
Create a key on your dashboard. MCP shares the same monthly quota as REST. - 2
Add the remote MCP URL
Point your client athttps://api.toolyour.com/mcpwith headerX-Api-Key. Use the config panel above for Cursor (~/.cursor/mcp.json), Claude Desktop, Claude Code, and other MCP-compatible agents. - 3
Agent workflow
Tryplan_taskthenrun_playbookorsolve_task— describe the job in plain language (e.g. "ship gate for https://preview.example.com"). solve_task is the primary MCP entry: plain-language goals route to workflows or tools with fuzzy matching, confidence gating, and synthesized job reports. Ambiguous goals return ranked suggestions instead of a wrong run. Ambiguous goals returnstatus: suggestwith rankedtaskSuggestions.plan_task(free) thenrun_playbookorsolve_task- Apply
loop.remainingFixesin the host repo (editor/git) verify_taskwith that result as baseline untilloop.gateis pass Discovery meta-tools are free and do not count toward quota. Execution bills like REST.
What are common ToolYour MCP questions?
How does this compare to Zapier MCP or GitHub MCP?
GitHub and Playwright MCPs serve repos and browsers. Zapier MCP connects agents to other apps. ToolYour is a remote MCP server for a utilities catalog (SEO, ship-gate, security, converters) with the same key as REST. Install those servers too when you need their jobs.
Is this a local or remote MCP server?
Remote. Agents connect over HTTPS to https://api.toolyour.com/mcp — no local install of ToolYour tools. Auth is X-Api-Key, the same header as REST, not a separate OAuth product login.
MCP vs REST — when should I use which?
Use REST when your app or backend calls tools programmatically. Use MCP when an AI agent (Cursor, Claude, etc.) should discover and run tools in conversation. Both share billing.
How mature is solve_task?
solve_task is the primary MCP entry: plain-language goals route to workflows or tools with fuzzy matching, confidence gating, and synthesized job reports. Ambiguous goals return ranked suggestions instead of a wrong run. Prefer plan_task (free) then run_playbook or solve_task(compact). Read loop.remainingFixes, apply the rank-1 loop.nextActions item in the host repo, then verify_task with the prior result as baseline until loop.gate is pass — or stop when loop.stop / loop.initiate is false (maxRounds=5, sameFindingsLimit=2). verify_task requires that baseline jobReport. Use discover_tools → invoke_tool only for an explicit one-off operationId, not for ship/SEO/security jobs.
What categories work over MCP?
File converters, SEO & site tools, documents, text utilities, unit converters, finance calculators, and AI utilities — any tool with API access enabled.
Full reference: MCP quickstart docs.