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

name

String

Programmatic name of the tool

title

StringNullable

Human-readable display title for the tool

description

StringNullable

Tool description

input_schema

ObjectNullable

JSON Schema defining the tool input parameters. Contains standard JSON Schema fields like type, properties, required, etc.

output_schema

ObjectNullable

JSON Schema defining the tool output format. Contains standard JSON Schema fields like type, properties, required, etc.

provider_id

String

Provider ID

provider_specification_id

String

Specification ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.tool",
  "id": "pto_5jKlMnPqRsTuVwXy",
  "name": "create_issue",
  "title": "Create Issue",
  "description": "Creates a new issue in a GitHub repository",
  "input_schema": {
    "type": "object",
    "properties": {
      "repo": {
        "type": "string",
        "description": "Repository name"
      },
      "title": {
        "type": "string",
        "description": "Issue title"
      }
    },
    "required": [
      "repo",
      "title"
    ]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "number",
        "description": "Issue ID"
      },
      "url": {
        "type": "string",
        "description": "Issue URL"
      }
    }
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
  "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.

URL Parameters

provider_id

String

The unique identifier for the provider

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

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

Get provider tool

Retrieves a specific provider tool by ID.

URL Parameters

provider_id

String

The unique identifier for the provider

provider_tool_id

String

The unique identifier for the provider_tool

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