Skip to main content

​
Tools API

Returns metadata for built-in native tools (name, description, and JSON schema).

​
Endpoint

GET /v1/tools

​
Authentication

Requires standard API authentication (API key or user JWT).

​
Response

Returns an array: 
[
  {
    "name": "grep",
    "description": "Keyword browse/search...",
    "schema": {
      "type": "object",
      "properties": {
        "query": { "type": "string" }
      },
      "required": ["query"]
    }
  }
]

​
Use Cases

  • Build tool pickers in internal dashboards
  • Introspect input schemas for CLI/MCP adapters
  • Keep tool documentation in sync with the runtime tool registry

​
Notes

  • Data comes from the same native tool metadata used by API, agent-end, and MCP integrations.
  • Output includes only native tools exposed through getNativeToolsForAPI().