> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helve.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search tools

> Natural-language discovery over Helve's tool catalog. Pass what your agent is trying to do and receive matching tool IDs, schemas, and pricing hints—or a `missing_tool_hint` when Helve does not cover that capability yet.



## OpenAPI

````yaml openapi.json POST /v1/tools/search
openapi: 3.1.0
info:
  title: Helve API
  version: 2.0.0
  description: >-
    Metered pay-per-call tool gateway for AI agents: search available tools via
    `/v1/tools/search`, call any tool immediately via `/v1/tools/call` with one
    Helve API key and zero third-party signups, plus unified `/v1/search`,
    `/v1/extract`, and `/v1/transcriptions` endpoints.
servers:
  - url: https://helve.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Catalog
    description: >-
      Discover 223 metered third-party and public utility tools, invoke any tool
      with one key, or request missing tools.
  - name: Search
    description: >-
      Web search with one schema across Exa, Parallel, Tavily, Brave, Serper,
      Firecrawl, Linkup, Valyu, Jina, Octen, Perplexity, and the `fusion` panel.
  - name: Extract
    description: Fetch and clean pages by URL.
  - name: Transcription
    description: >-
      Durable speech-to-text jobs across AssemblyAI, Deepgram, and ElevenLabs.
      Submit a recording, poll the job.
paths:
  /v1/tools/search:
    post:
      tags:
        - Catalog
      summary: Search tools by capability
      description: >-
        Natural-language discovery over Helve's tool catalog. Pass what your
        agent is trying to do and receive matching tool IDs, schemas, and
        pricing hints—or a `missing_tool_hint` when Helve does not cover that
        capability yet.
      operationId: searchTools
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  minLength: 1
                  maxLength: 500
                  example: sec 10-k filings
                category:
                  type: string
                limit:
                  type: integer
                  minimum: 1
                  maximum: 30
                include_unavailable:
                  type: boolean
              required:
                - query
      responses:
        '200':
          description: Matching tools ranked by relevance
          content:
            application/json:
              schema:
                type: object
                properties:
                  tools:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: openrouter.chat
                        name:
                          type: string
                          example: OpenRouter LLM Chat Completions
                        provider:
                          type: string
                          example: openrouter
                        category:
                          type: string
                          example: llm
                        description:
                          type: string
                        keywords:
                          type: array
                          items:
                            type: string
                        replaces_signup:
                          type: string
                        pricing_hint:
                          type: string
                        available:
                          type: boolean
                        input_schema:
                          type: object
                          additionalProperties:
                            nullable: true
                        example:
                          type: object
                          additionalProperties:
                            nullable: true
                        score:
                          type: number
                      required:
                        - id
                        - name
                        - provider
                        - category
                        - description
                        - keywords
                        - replaces_signup
                        - pricing_hint
                        - available
                        - input_schema
                        - example
                        - score
                  total_catalog_tools:
                    type: integer
                  missing_tool_hint:
                    type: string
                required:
                  - tools
                  - total_catalog_tools
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - unauthorized
                          - invalid_request
                          - provider_not_available
                          - provider_not_configured
                          - provider_error
                          - not_found
                          - insufficient_credits
                          - spend_limit_exceeded
                          - internal_error
                        description: >-
                          Stable machine-readable category. `invalid_request`
                          carries validation issues in `detail`;
                          `provider_error` carries the provider's own error
                          body.
                      message:
                        type: string
                        description: Human-readable explanation.
                      detail:
                        nullable: true
                        description: >-
                          Validation issues for `invalid_request`; the
                          provider's error body for `provider_error`.
                    required:
                      - type
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key from the dashboard, `sk_live_…`, sent as `Authorization:
        Bearer sk_live_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.