Provider Tools

A tool is a single action a provider can perform like 'search_issues' or 'send_message'. Tools are what AI agents call via MCP. By default, tools from the latest provider version are returned. Use the optional version filter to get tools for a specific version.

Provider Tools object

Attributes

object

String

String representing the object's type

id

String

Unique tool identifier

key

String

Tool key

name

String

Display name of the tool

description

StringNullable

Tool description

capabilities

Object

Tool capabilities

constraints

Array of Strings

Tool constraints

instructions

Array of Strings

Tool usage instructions

input_schema

ObjectNullable

output_schema

ObjectNullable

tags

ObjectNullable

specification_id

String

Specification ID

provider_id

String

Provider ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.tool",
  "id": "pto_5jKlMnPqRsTuVwXy",
  "key": "create_issue",
  "name": "Create Issue",
  "description": "Creates a new issue in a GitHub repository",
  "capabilities": {},
  "input_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "output_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "tags": {},
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider tools

Returns a paginated list of provider tools. By default returns tools from the latest version. Use optional filters to get tools for a specific version.

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

provider_version_id

String
GEThttp://api.metorial.com/providers-tools
curl -X GET "https://api.metorial.com/providers-tools" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider tool

Retrieves a specific provider tool by ID.

URL Parameters

provider_tool_id

String

The unique identifier for the provider_tool

GEThttp://api.metorial.com/providers-tools/:provider_tool_id
curl -X GET "https://api.metorial.com/providers-tools/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."