> ## 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.

# List tools

> Returns all metered third-party and zero-auth utility tools currently available on Helve, including their JSON input schemas, pricing hints, and example arguments.



## OpenAPI

````yaml openapi.json GET /v1/tools
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:
    get:
      tags:
        - Catalog
      summary: List available tools
      description: >-
        Returns all metered third-party and zero-auth utility tools currently
        available on Helve, including their JSON input schemas, pricing hints,
        and example arguments.
      operationId: listTools
      parameters:
        - schema:
            type: string
            description: >-
              Optional category filter (llm, embeddings, search, extract,
              crawl_map, research_answer, audio_tts, transcription, finance,
              developer_data, knowledge_geo, utilities)
          required: false
          description: >-
            Optional category filter (llm, embeddings, search, extract,
            crawl_map, research_answer, audio_tts, transcription, finance,
            developer_data, knowledge_geo, utilities)
          name: category
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: Include tools not yet configured on this server
          required: false
          description: Include tools not yet configured on this server
          name: include_unavailable
          in: query
      responses:
        '200':
          description: Catalog tool list
          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
                      required:
                        - id
                        - name
                        - provider
                        - category
                        - description
                        - keywords
                        - replaces_signup
                        - pricing_hint
                        - available
                        - input_schema
                        - example
                  total:
                    type: integer
                  catalog_total:
                    type: integer
                  meta:
                    type: object
                    properties:
                      total_tools:
                        type: integer
                      catalog_total:
                        type: integer
                      total_providers:
                        type: integer
                      total_categories:
                        type: integer
                      free_tools:
                        type: integer
                      paid_tools:
                        type: integer
                    required:
                      - total_tools
                      - catalog_total
                      - total_providers
                      - total_categories
                      - free_tools
                      - paid_tools
                required:
                  - tools
                  - total
                  - catalog_total
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.