io.github.Humanleap/toolrouter

ToolRouter

The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.

0.3.2
Version
remote
Transport
48
Tools

Security review

Review passed

Reviewed 23h ago.

  • tools: 48 tools scanned
  • metadata: scanned

No findings.

Tools (48)

  • account_setup

    Initialize or re-check your account, provision it when needed, and return your user ID and plan. CALL THIS FIRST when the user asks to set up ToolRouter, connect their account, check their account status, or get started.

  • account_list

    List all billing contexts (personal + teams) or get detail on one. No slug → summary list. With slug → full detail including team members, role, subscription status, and pointers to the team's connectors, credentials, keys, and files.

  • account_switch

    Set the active billing context. Accepts a slug (e.g. "personal", "team:nd7fx…") or team ID.

  • account_preferences

    Read or write billing preferences (auto-reload, budget cap, default context). Pass action: "get" to read, action: "set" with fields to write.

  • credits_balance

    Current balance, plan tier, rate limits, and any negative-balance warnings for the active context.

  • credits_usage

    Usage summary or history. Pass scope: "me" | "team" and detail: "tool" | "skill". Sorted by cost with _others rollup.

  • subscription_manage

    Get a Stripe management URL (portal, upgrade, or cancel). Also covers billing portal — returns the URL for the user to open.

  • invoice_list

    List invoices for the active billing context.

  • key_list

    List API keys (summary) or get detail on one key. Pass key_id for detail view.

  • key_create

    Create a new API key. Returns the secret once — save it immediately.

  • key_delete

    Revoke an API key. Refuses to revoke the currently-authenticating key.

  • credential_list

    List saved credentials (summary) or detail on one. Pass name for detail view. Pass show_available: true to include the full credential catalog.

  • credential_save

    Save a credential (BYOK provider API key). Saved keys persist across sessions and are used automatically.

  • credential_delete

    Remove a saved credential. If label is provided, removes only that specific entry. If no label, removes ALL entries for that credential name.

  • credential_default

    Set the default value for a multi-value credential.

  • credential_guide

    Get setup instructions for a specific credential.

  • file_list

    List or search files. Optional query triggers semantic search. Supports section, tags, plan_status, limit, cursor filters.

  • file_read

    Read a file's full content. Text files return content inline. Binary files (images, video) return a download URL.

  • file_write

    Create or update a file. Pass mode: "create" | "update". Binary uploads: call with binary: true to get an upload_url, then PUT bytes, then call with mode: "finalize".

  • file_delete

    Delete a file. Cannot be undone. For team files: requires owner/admin role.

  • persona_list

    List your personas.

  • scene_list

    List your scenes.

  • product_list

    List your products.

  • outfit_list

    List your outfits.

  • connector_list

    List connected accounts and MCP servers (summary) or detail on one connector. Pass slug for detail including every tool the connector exposes. Optional type: "oauth" | "mcp" filter. Pass include_available: true to also see available catalog MCPs you can connect.

  • connector_add

    Connect a new OAuth account or MCP server. For OAuth: pass type: "oauth", kind: "slack". For MCP catalog: pass catalog_slug. For custom MCP: pass url + auth_type.

  • connector_remove

    Disconnect a connector. Pass slug.

  • brain_admin

    Brain admin operations. Pass action: "lint" | "link" | "promote" | "rebuild_index" | "team_sleep". team_sleep enables/disables/runs the nightly team consolidation cycle — pass sub_action "enable" (with optional timezone), "disable", "status", or "run_now". Team admin role required for team_sleep actions.

  • job_list

    List your active and recent jobs. Optional status filter.

  • job_get

    Get job status and result. Returns status: running | completed | failed and result when terminal. Keep polling until you get a terminal status.

  • job_cancel

    Cancel a running job.

  • feedback_review

    Submit a review or star rating.

  • feedback_debug

    Report a ToolRouter platform bug that blocks you from completing the user's task. Use this when you suspect the issue is on our side — a tool crashed, returned malformed data, timed out unexpectedly, or behaved inconsistently. Include the relevant ToolRouter errors, call IDs, non-sensitive input shape, retries, and expected behavior. Do not include chat history, unrelated conversation text, uploaded file contents, personal data, API keys, or secrets. Reports are stored and reviewed within hours. Skip this for expected errors like invalid input, missing credentials, insufficient balance, rate limits, or genuine "not found" results — those aren't bugs. Limit: 5 reports per hour.

  • feedback_request_tool

    Ask ToolRouter to build a tool that does not exist yet. Use this when discover returned nothing useful for what the user needs. Describe the capability in plain terms — do not include personal data, API keys, or secrets. Requests go straight to the team. Limit: 5 per hour.

  • top_up_credits

    Add credits to your account. Returns a Stripe checkout URL — share it with the user to complete payment. Minimum $1.

  • discover

    Find the right ToolRouter tool for your task. Describe what you need in plain language. Examples: "analyze a website", "research competitors", "find prospect companies", "check DNS records". Exact tool name (e.g. "seo") returns full schemas and examples. Flow: prefer route({ intent }) to pick and run a tool. Use discover when you need schemas or a listing, then call use_tool(tool, skill, input). Every discover response also includes a top-level `connectors` array listing SaaS accounts the user has already connected (LinkedIn, Google, Notion, etc.). Use that to pick the right tool and account without asking — e.g. if `connectors` shows LinkedIn, the linkedin-post tool is ready to use. Categories: data, media, search, marketing, development, communication, analytics, productivity, ai, finance, security, infrastructure

  • route

    Send a natural-language intent and optionally any dimensions you already know (tool, skill, model, input fields). Fills only the blanks via Jev, then either executes the call or returns a ready-to-run use_tool payload. Explicit values are never overridden. Returns candidates when confidence is low or no tool fits. Flow: route → if confident and complete, result is returned; otherwise use the pre-filled call with use_tool.

  • use_tool

    Call a ToolRouter catalogue tool. Prefer `route` with a natural-language intent when you do not already know the tool and skill — it picks them, fills arguments, and runs the call. Use discover when you need schemas or a catalogue listing, then pass the exact tool name and skill here. IMPORTANT: "discover", "route", "credits_balance", and other built-in tools are NOT catalogue tools — call them directly, never through use_tool. Long-running tools return a job_id — poll with job_get. If a skill needs an image_url or file URL and you have a local file or base64 image, use file_write first to get a hosted URL, then pass that URL to the skill. BRAIN: Some tools require you to consult brain_query first. If use_tool returns an error about brain_context, call brain_query with a relevant query, then pass the result text as brain_context in your use_tool input.

  • brain_query

    Search your knowledge brain for relevant information. Returns pages ranked by relevance. Optional wing/hall narrow the search to a slice of the brain (e.g. wing="engineering", hall="preference").

  • brain_add

    Create a new brain page. Knowledge you add here will be available to all future tool calls. Optional wing/room/hall organise the page in the MemPalace hierarchy for sharper retrieval.

  • brain_update

    Edit an existing brain page's content or metadata. wing/room/hall can be patched to re-file a page. scope can be changed to move a page between your personal and team brain — useful when an auto-ingested page landed in the wrong place. Moving a page to team scope requires team admin role.

  • brain_delete

    Archive a brain page. It will no longer appear in searches or tool consultations.

  • brain_status

    View brain page counts and recent pages for your personal and team brain.

  • brain_lint

    Run maintenance checks on your brain: find stale pages, orphaned knowledge, and other issues.

  • brain_settings

    View and toggle your brain settings. Currently supports: drawers_enabled (store raw tool output alongside summaries for richer recall).

  • brain_expand

    Retrieve the verbatim source text (a "drawer") linked from a brain page. Use this when a summary lacks specifics you need — drawers contain the original tool output, redacted for credentials. Returns 404 if the page has no linked drawer (not all pages do — drawers are a Step 4 feature for allowlisted tools only).

  • brain_wings

    List the wings of your brain — the top-level areas your knowledge is organised under (e.g. "engineering", "family"). For each wing returns the rooms and halls inside, page count, and last-updated time. Use this to discover the right wing/hall to pass to brain_query.

  • connector_permissions

    View or set permissions for tools on a connected MCP server — which tools are allowed, rate limits, budget caps, argument restrictions. Pass the connector slug (from connector_list) and action: "list" to see current rules, or action: "set" with tool_name + rules to update one. Team scope requires admin role.