Gatana Tools API
The tools API from Gatana — 3 operation(s) for tools.
The tools API from Gatana — 3 operation(s) for tools.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/gatana-ai:gatana-ai-tools-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Gatana Tools API
version: v1.48.6
description: ''
servers:
- url: https://{YOUR_ORG_ID}.gatana.ai/api/v1
description: Gatana Public API
variables:
YOUR_ORG_ID:
default: YOUR_ORG_ID
description: Gatana organization identifier
security:
- Static Bearer Token: []
- OAuth2: []
tags:
- name: Tools
paths:
/tools:
get:
responseType:
def:
type: object
shape:
tools:
def:
type: array
element:
def:
type: object
shape:
tenantId:
def:
type: string
type: string
toolName:
def:
type: string
type: string
description:
def:
type: string
type: string
schema:
def:
type: object
shape: {}
type: object
outputSchema:
def:
type: nullable
innerType:
def:
type: object
shape: {}
type: object
type: nullable
annotations:
def:
type: nullable
innerType:
def:
type: object
shape: {}
type: object
type: nullable
isEnabled:
def:
type: boolean
type: boolean
toolNameOverride:
def:
type: string
type: string
descriptionOverride:
def:
type: string
type: string
inputSchemaOverride:
def:
type: object
shape: {}
type: object
overrideToolName:
def:
type: boolean
type: boolean
overrideDescription:
def:
type: boolean
type: boolean
overrideInputSchema:
def:
type: nullable
innerType:
def:
type: boolean
type: boolean
type: nullable
serverSlug:
def:
type: string
type: string
universalName:
def:
type: string
type: string
type: object
type: array
element:
def:
type: object
shape:
tenantId:
def:
type: string
type: string
toolName:
def:
type: string
type: string
description:
def:
type: string
type: string
schema:
def:
type: object
shape: {}
type: object
outputSchema:
def:
type: nullable
innerType:
def:
type: object
shape: {}
type: object
type: nullable
annotations:
def:
type: nullable
innerType:
def:
type: object
shape: {}
type: object
type: nullable
isEnabled:
def:
type: boolean
type: boolean
toolNameOverride:
def:
type: string
type: string
descriptionOverride:
def:
type: string
type: string
inputSchemaOverride:
def:
type: object
shape: {}
type: object
overrideToolName:
def:
type: boolean
type: boolean
overrideDescription:
def:
type: boolean
type: boolean
overrideInputSchema:
def:
type: nullable
innerType:
def:
type: boolean
type: boolean
type: nullable
serverSlug:
def:
type: string
type: string
universalName:
def:
type: string
type: string
type: object
type: object
description: List all cached tools of every MCP server the caller has access to, including the disabled ones
operationId: listTools
tags:
- Tools
parameters:
- in: query
name: search
schema:
type: string
- in: query
name: schemas
schema:
default: 'true'
description: Set to false to blank the tool schemas in the response
$ref: '#/components/schemas/__schema207'
description: Set to false to blank the tool schemas in the response
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/__schema752'
summary: List tools
x-summary-source: derived
/tools/search:
get:
responseType:
def:
type: object
shape:
pagination:
def:
type: object
shape:
page:
def:
type: number
checks: []
type: number
isFinite: true
limit:
def:
type: number
checks: []
type: number
isFinite: true
total:
def:
type: number
checks: []
type: number
isFinite: true
totalPages:
def:
type: number
checks: []
type: number
isFinite: true
hasNext:
def:
type: boolean
type: boolean
hasPrev:
def:
type: boolean
type: boolean
type: object
data:
def:
type: array
element:
def:
type: object
shape:
toolName:
def:
type: string
type: string
toolNameOverride:
def:
type: string
type: string
description:
def:
type: string
type: string
descriptionOverride:
def:
type: string
type: string
serverSlug:
def:
type: string
type: string
isEnabled:
def:
type: boolean
type: boolean
checks: []
type: object
type: array
element:
def:
type: object
shape:
toolName:
def:
type: string
type: string
toolNameOverride:
def:
type: string
type: string
description:
def:
type: string
type: string
descriptionOverride:
def:
type: string
type: string
serverSlug:
def:
type: string
type: string
isEnabled:
def:
type: boolean
type: boolean
checks: []
type: object
type: object
description: Search the cached tools of every MCP server the caller has access to, page by page, including the disabled ones. Returns a list of tools paginated.
operationId: getToolsSearch
tags:
- Tools
parameters:
- in: query
name: serverId
schema:
type: string
- in: query
name: serverSlug
schema:
type: string
- in: query
name: search
schema:
type: string
- in: query
name: page
schema:
type: string
- in: query
name: limit
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
pagination:
$ref: '#/components/schemas/__schema513'
data:
type: array
items:
$ref: '#/components/schemas/__schema772'
description: Items on the current page
required:
- pagination
- data
additionalProperties: false
summary: Get tools search
x-summary-source: derived
/tools/refresh:
post:
responseType:
def:
type: any
type: any
description: Refresh the tool cache of one MCP server, or of all enabled servers when serverSlug is omitted. Streams the progress as server-sent events, so the Accept header must be text/event-stream
operationId: refreshTools
tags:
- Tools
parameters:
- in: query
name: serverSlug
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema: {}
summary: Refresh tools
x-summary-source: derived
components:
schemas:
__schema513:
type: object
properties:
page:
$ref: '#/components/schemas/__schema514'
limit:
$ref: '#/components/schemas/__schema515'
total:
$ref: '#/components/schemas/__schema516'
totalPages:
$ref: '#/components/schemas/__schema517'
hasNext:
$ref: '#/components/schemas/__schema518'
hasPrev:
$ref: '#/components/schemas/__schema519'
required:
- page
- limit
- total
- totalPages
- hasNext
- hasPrev
additionalProperties: false
description: Pagination metadata
__schema761:
type: boolean
description: Whether the tool is enabled and exposed to clients
__schema769:
type: string
__schema753:
type: string
description: ID of the tenant that owns the tool
__schema517:
type: number
description: Total number of pages
ServerToolDto:
type: object
properties:
tenantId:
$ref: '#/components/schemas/__schema753'
toolName:
$ref: '#/components/schemas/__schema754'
description:
$ref: '#/components/schemas/__schema755'
schema:
$ref: '#/components/schemas/__schema756'
outputSchema:
$ref: '#/components/schemas/__schema757'
annotations:
$ref: '#/components/schemas/__schema759'
isEnabled:
$ref: '#/components/schemas/__schema761'
toolNameOverride:
$ref: '#/components/schemas/__schema762'
descriptionOverride:
$ref: '#/components/schemas/__schema763'
inputSchemaOverride:
$ref: '#/components/schemas/__schema764'
overrideToolName:
$ref: '#/components/schemas/__schema765'
overrideDescription:
$ref: '#/components/schemas/__schema766'
overrideInputSchema:
$ref: '#/components/schemas/__schema767'
serverSlug:
$ref: '#/components/schemas/__schema769'
universalName:
$ref: '#/components/schemas/__schema770'
required:
- tenantId
- toolName
- description
- schema
- outputSchema
- annotations
- isEnabled
- toolNameOverride
- descriptionOverride
- inputSchemaOverride
- overrideToolName
- overrideDescription
- overrideInputSchema
- serverSlug
- universalName
additionalProperties: false
__schema519:
type: boolean
description: Whether a previous page exists
__schema764:
type: object
properties: {}
additionalProperties: false
description: Replacement input schema, applied when overrideInputSchema is true
__schema516:
type: number
description: Total number of items across all pages
__schema760:
type: object
properties: {}
additionalProperties: false
__schema759:
anyOf:
- $ref: '#/components/schemas/__schema760'
- type: 'null'
description: Tool annotations as reported by the MCP server, or null if none
__schema768:
type: boolean
__schema754:
type: string
description: Tool name as reported by the MCP server
__schema762:
type: string
description: Replacement tool name, applied when overrideToolName is true
__schema755:
type: string
description: Tool description as reported by the MCP server
__schema766:
type: boolean
description: Whether descriptionOverride replaces the original description
__schema518:
type: boolean
description: Whether a next page exists
__schema758:
type: object
properties: {}
additionalProperties: false
__schema752:
type: object
properties:
tools:
type: array
items:
$ref: '#/components/schemas/ServerToolDto'
required:
- tools
additionalProperties: false
__schema772:
type: object
properties:
toolName:
$ref: '#/components/schemas/__schema754'
toolNameOverride:
$ref: '#/components/schemas/__schema762'
description:
$ref: '#/components/schemas/__schema755'
descriptionOverride:
$ref: '#/components/schemas/__schema763'
serverSlug:
$ref: '#/components/schemas/__schema769'
isEnabled:
$ref: '#/components/schemas/__schema761'
required:
- toolName
- toolNameOverride
- description
- descriptionOverride
- serverSlug
- isEnabled
additionalProperties: false
__schema770:
type: string
__schema207:
type: string
__schema763:
type: string
description: Replacement description, applied when overrideDescription is true
__schema765:
type: boolean
description: Whether toolNameOverride replaces the original tool name
__schema757:
anyOf:
- $ref: '#/components/schemas/__schema758'
- type: 'null'
description: JSON schema for the tool output, or null if the server does not provide one
__schema767:
anyOf:
- $ref: '#/components/schemas/__schema768'
- type: 'null'
description: Whether inputSchemaOverride replaces the original input schema
__schema756:
type: object
properties: {}
additionalProperties: false
description: JSON schema for the tool input
__schema514:
type: number
description: Current page number
__schema515:
type: number
description: Maximum number of items per page
securitySchemes:
Static_Bearer_Token:
type: http
scheme: bearer
OAuth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
scopes:
openid: Authentication claims