MetorialDocs

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.

The Provider Tool object

provider_tool.json
{
  "object": "provider.tool",
  "id": "pto_5jKlMnPqRsTuVwXy",
  "key": "create_issue",
  "name": "Create Issue",
  "description": "Creates a new issue in a GitHub repository",
  "capabilities": {},
  "constraints": [
    "example_constraints"
  ],
  "instructions": [
    "example_instructions"
  ],
  "input_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "output_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "tags": {
    "destructive": false,
    "read_only": false
  },
  "tool_category_keys": [
    "crm"
  ],
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}
object"provider.tool"required
idstringrequired
keystringrequired
namestringrequired
descriptionstringrequirednullable
capabilitiesRecord<string, any>required
constraintsstring[]required
instructionsstring[]required
tool_category_keysstring[]required
specification_idstringrequired
provider_idstringrequired
created_atdaterequired
updated_atdaterequired

Endpoints

List provider tools

GET/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

provider_version_idstringrequired
provider_auth_method_idstring or string[]optional

Filter to tools compatible with one auth method ID, or the common compatible subset for multiple auth method IDs.

Example request

curl -X GET "https://api.metorial.com/provider-tools" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get provider tool

GET/provider-tools/:provider_tool_id

Retrieves a specific provider tool by ID.

Path parameters

provider_tool_idstringrequired

The unique identifier for the provider_tool

Example request

curl -X GET "https://api.metorial.com/provider-tools/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."