search_tools

Use search_tools to query the UseAgents registry with a plain-language request. This helps your agent discover real tools instead of fabricating package names or relying on stale memory.

Requires an API key. Configure the x-api-key header when connecting the MCP server.

Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Natural-language query. Searches across tool names, descriptions, tags, languages, and categories.
`language`	string	No	Filter results by supported SDK language
`transport`	string	No	Filter by `api`, `cli`, or `mcp`
`category`	string	No	Filter by an exact category
`format`	string	No	Response format: `toon` (default) or `json`

Query guidance

Good queries usually include:

The problem to solve
The language or framework
Important constraints such as deployment model or integration surface

Example queries:

authentication library for Node.js
python sdk for Slack bots
self-hosted feature flag service for Go

Returns

By default the tool returns results in Toon. Pass format: "json" for JSON text. Learn more at toonformat.dev and Response formats. Each result includes:

Field	Type	Description
`name`	string	Tool name
`description`	string	Full description of what the tool does
`languages`	string[]	Supported languages
`transports`	string[]	Supported access surfaces (`api`, `cli`, `mcp`)
`sources`	object	Canonical website, docs, and repository links
`categories`	string[]	Tool categories
`slug`	string	URL-friendly identifier for the tool
`updatedAt`	string \| null	ISO timestamp when the tool was last updated; `null` if unavailable

Example call

{
  "q": "authentication library for Node.js",
  "language": "typescript-javascript",
  "transport": "api"
}

Example response (Toon format):

results[1]:
  - name: Example Auth SDK
    description: A TypeScript authentication library for Node.js applications.
    languages[2]: TypeScript,JavaScript
    transports[1]: api
    sources:
      website: https://example.com
      docsUrl: https://example.com/docs
      repoUrl: https://github.com/example/auth-sdk
    categories[2]: Authentication,SDK
    slug: example-auth-sdk
    updatedAt: 2026-07-23T12:00:00.000Z

Use this tool when

The agent needs to recommend a library, CLI, SDK, or API
The agent should avoid fabricating or guessing tool names
The agent needs accurate metadata before selecting a dependency

Typical workflow

Call search_tools with a task-focused query.
Review the ranked results and metadata.
Call get_tool_context for the selected slug.
Call search_docs when you need deeper answers from that tool’s official docs.

Get Started

MCP

Clients

Parameters

Query guidance

Returns

Example call

Use this tool when

Typical workflow

​Parameters

​Query guidance

​Returns

​Example call

​Use this tool when

​Typical workflow

Parameters

Query guidance

Returns

Example call

Use this tool when

Typical workflow