Discover and run ToolRouter tools through one MCP connection for web search, scraping, SEO research, image and video generation, audio, company and economic data, and supported connected-account actions including X and LinkedIn posting. Use when ToolRouter is connected or the user chooses it for an external task.
ToolRouter
One connection gives an assistant access to hundreds of hosted tools and provider operations. Discover the right operation before calling it; the live catalog determines availability, input fields and account requirements.
Installation
Install this skill with pnpm dlx skills add Humanleap/agent-skills --skill toolrouter. Connect the client's remote MCP server to https://api.toolrouter.com/mcp using its authentication flow. Setup: https://toolrouter.com/docs/markdown/quickstart.
Four Hard Rules — Read First
- Discover first. Use returned operation schemas; never invent a tool, provider connection or input field.
- Respect the chosen provider. A capability request does not authorise connecting another account, changing billing, or replacing a service the user specified.
- Check action and spending authority. Posting, deleting, messaging and paid operations require authority for that task. A catalog entry does not establish access to the user's accounts.
- Finish the actual job. A queued job is unfinished. Check status before repeating an uncertain write and report provider errors or missing credentials plainly.
Authentication
Read tools/list for the current client profile. Follow the advertised OAuth or account-claim flow and keep credentials in the client credential store. Do not include tokens in chat, skills or shared configuration. Some operations use hosted providers; others require a connected provider account. Check the operation before promising access.
Core Workflow
- Discover the outcome. Call
discoverwith aquerydescribing the job: research a company, check keyword demand, extract a website, generate an image, transcribe media, or publish an authorised social post. - Read the operation. Select the returned
toolandskill; inspect the exact input schema, price, account requirements and limitations. - Execute. Call
use_toolwith thattool,skilland schema-matchinginput. Built-in MCP tools are called directly. Checkcredits_balancewhen the task needs paid credits. - Resolve asynchronous work. Follow the returned job handle with the advertised status tool, such as
job_get, until outputs are ready or a blocker is reported. - Return the useful result. Share source links, completed assets or the provider's verified action result, with relevant dates and limitations.
Essential Tools
| Tool | Use |
|---|---|
discover | Find operations, schemas and examples for the requested outcome or exact tool. |
use_tool | Execute one discovered provider operation. |
credits_balance | Inspect the account's credit balance when available. |
job_get | Check an asynchronous job when the returned response supplies a handle for it. |
Inspect tools/list before relying on a built-in name: client profiles and the catalog can change.
Common Patterns
- Research and extraction: discover web search or scraping, use original source URLs, then extract the fields the user needs.
- SEO: discover keyword, SERP, backlink or competitor operations; retain provider, market, time range and measurement limits.
- Creative work: discover the model or media operation, respect the approved budget, then poll and return completed output URLs.
- Business and economic data: select the original registry or statistical source and retain dates, units and geography.
- Social publishing: discover the exact account operation. Supported catalog examples include
linkedin-post.post_text,linkedin-post.post_link,linkedin-post.post_image,x-manager.post_tweetandx-manager.post_image_tweet. Confirm the connected account and authorised content from the request; discover the current schema before executing.
Providers and Supporting Resources
Read the provider reference when a task names a provider. It lists all 55 entries in the public provider index as of 3 October 2026, including Firecrawl, Exa, Serper, DataForSEO, OpenAI, Anthropic, fal.ai, ElevenLabs, Google, OpenRouter, Companies House, SEC EDGAR and the World Bank. Public provider pages describe integrations; they do not prove every operation is deployed or that the user has access.
- Provider index: https://toolrouter.com/providers.md
- Public catalog: https://api.toolrouter.com/v1/tools
- REST schema: https://api.toolrouter.com/openapi.json
Common Gotchas
- The website's provider count and the deployed tool count can differ. Use the live operation schema.
- A social connection does not imply support for every social platform or permission to post.
- Some client-specific MCP profiles expose fewer operations. Do not promise media generation in a profile that filters it out.
- An empty search result is a coverage limit, not proof of absence.
Quick Reference
Connect → discover → inspect schema and authority → use_tool → resolve job → share verified result.
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 1mo ago
- Current version
- v1.1.0
- License
- MIT-0
