---
title: "tools.made-tool@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/tools.made-tool"
updated: null
---

# tools.made-tool@1 · OpenVibe.Services

HTML: [tools.made-tool@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/tools.made-tool)

# MadeTool `tools.made-tool@1`

Generated at 2026-11-17 06:52:56 UTC from [`openvibe-contracts v0.443.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.443.0) and [`openvibe-sdk v0.177.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.177.0).

- Version: 1.1.0
- Owner: tools
- Visibility: public
- Status: active
- Compatibility: backward
- Schema: [`https://openvibe.network/contracts/tools/made-tool.v1.json`](/docs/contracts/tools.made-tool.json)

A tool a person made on openvibe.tools (plan 2026-11-13 §AD.7 step 2; the owner, 11-15: "people should be able to make their own tools … AI or Codes to generate them … model selection and OpenVibe.exchange"). GET /api/v1/made-tools/:id answers one, GET /api/v1/made-tools (public ones) and /api/v1/made-tools?mine=1 (the caller's own) list them; POST makes one and PATCH changes it (each change is the next version); DELETE removes it. KIND says how it runs. A prompt tool is instructions and a model: a run sends the instructions and the input to the model through OpenVibe.AI as the person who runs it (on\_behalf\_of: their free allowance, their Vibes or their own keys pay, never the tool's maker), and the answer is result.data (output.kind json, checked against output.schema) or result.text (output.kind text). A code tool is one JavaScript entry pinned by its sha256 that runs as a skill-runner function job (JSON in on stdin, at most 64 KiB of JSON out, no spawn, write or eval, the network that NET allows) placed by OpenVibe.Run on HOSTING: openvibe (OpenVibe's runner), mine (the owner's own Link nodes) or shared (nodes that serve others). INPUT is the JSON Schema (2020-12) a run's input must match. VISIBILITY: private (the owner alone sees and runs it), unlisted (anyone with its id runs it; never listed or indexed) or public (listed, searchable, runnable by anyone signed in). RUN.PATH is POST /api/v1/made-tools/{id}/run, body { input }, answered with tools.run@1. A CHAIN tool (1.1.0) runs other tools in order: each step names a tool (a catalogue id or a made tool's mtl\_ id) and its input, whose values may be templates: "{{input.<field>}}" (the chain's own input) or "{{steps.<n>.<path>}}" (an earlier step's result data, or text for a text result); a value that is only a template takes the value as it is, a template inside other words is written in as text. The chain's answer is the last step's result (output\_from last) or every step's (all). A chain runs as the person who runs it: every step is one run with their own credentials and paid as that run is. RULES this schema enforces: a prompt tool has prompt and no code; a code tool has code and no prompt; a chain tool has chain and neither; json output has a schema.

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `id` | string | yes | The tool's id. It never changes. | - `pattern ^mtl_[0-9A-HJKMNP-TV-Z]{26}$` |
| `owner` | object | yes | Who made it. | - `no other fields` |
| `owner.subject` | string | yes |  | - `pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$` |
| `owner.name` | string |  | Their display name when the tool was read, for people. | - `minLength 1`<br>- `maxLength 80` |
| `slug` | string | yes | A short name, unique among the owner's tools (summarize-email), for addresses and an agent's tool list. | - `pattern ^[a-z][a-z0-9-]{1,39}$` |
| `name` | string | yes |  | - `minLength 1`<br>- `maxLength 80` |
| `summary` | string | yes | One plain sentence: what the tool does. Agents read it to decide when to use the tool. | - `minLength 1`<br>- `maxLength 200` |
| `kind` | enum | yes | prompt: instructions run by a model through OpenVibe.AI. code: a JavaScript entry run as a skill-runner function job. chain (1.1.0): other tools run in order, each step's input from the chain's input or an earlier step. | - `one of "prompt", "code", "chain"` |
| `input` | object | yes | JSON Schema (2020-12) of a run's input: an object schema. |  |
| `input.type` | const | yes |  | - `= "object"` |
| `output` | object | yes |  | - `no other fields` |
| `output.kind` | enum | yes | json: result.data, checked against schema. text: result.text. | - `one of "json", "text"` |
| `output.schema` | object |  | JSON Schema of result.data. Required when kind is json. |  |
| `output.schema.type` | const | yes |  | - `= "object"` |
| `prompt` | object \| null | yes | A prompt tool's instructions and model; null for a code tool. |  |
| `code` | object \| null | yes | A code tool's entry; null for a prompt tool. |  |
| `net` | enum | yes | The network a code tool may reach: none, the public internet (through the egress guard), or OpenVibe's own sites only. A prompt tool reaches no network (deny). | - `one of "deny", "public", "openvibe-only"` |
| `hosting` | enum | yes | Where a code tool runs: OpenVibe's runner, the owner's own Link nodes, or nodes shared with others. A prompt tool runs on OpenVibe (openvibe). | - `one of "openvibe", "mine", "shared"` |
| `visibility` | enum | yes |  | - `one of "private", "unlisted", "public"` |
| `version` | integer | yes | 1 when made; each change adds one. | - `minimum 1` |
| `run` | object | yes |  | - `no other fields` |
| `run.method` | const | yes |  | - `= "POST"` |
| `run.path` | string | yes |  | - `pattern ^/api/v1/made-tools/mtl_[0-9A-HJKMNP-TV-Z]{26}/run$` |
| `runs` | integer |  | How many times it has run (all callers). | - `minimum 0` |
| `created_at` | string | yes |  | - `format date-time` |
| `updated_at` | string | yes |  | - `format date-time` |
| `chain` | object \| null |  | A chain tool's steps (1.1.0); absent or null for the other kinds. |  |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: chain-tool

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "site-check",
  "name": "Site check",
  "summary": "Looks up a domain's DNS, then summarizes it in plain words.",
  "kind": "chain",
  "input": {
    "type": "object",
    "required": [
      "domain"
    ],
    "properties": {
      "domain": {
        "type": "string"
      }
    }
  },
  "output": {
    "kind": "text"
  },
  "prompt": null,
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z",
  "chain": {
    "steps": [
      {
        "tool": "dns",
        "name": "Look up the DNS",
        "input": {
          "target": "{{input.domain}}"
        }
      },
      {
        "tool": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
        "name": "Say it plainly",
        "input": {
          "message": "The DNS of {{input.domain}}: {{steps.0.records}}"
        }
      }
    ],
    "output_from": "last"
  }
}
~~~~

Valid: code-tool

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAX",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW"
  },
  "slug": "csv-columns",
  "name": "CSV columns",
  "summary": "Lists a CSV's columns and how many rows it has.",
  "kind": "code",
  "input": {
    "type": "object",
    "required": [
      "csv"
    ],
    "properties": {
      "csv": {
        "type": "string",
        "maxLength": 60000
      }
    }
  },
  "output": {
    "kind": "json",
    "schema": {
      "type": "object",
      "properties": {
        "columns": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "rows": {
          "type": "integer"
        }
      }
    }
  },
  "prompt": null,
  "code": {
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "entry": "tool.js",
    "source": "https://git.openvibe.codes/ada/csv-columns",
    "bytes": 1412
  },
  "net": "deny",
  "hosting": "mine",
  "visibility": "private",
  "version": 1,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAX/run"
  },
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:00:00.000Z"
}
~~~~

Valid: prompt-tool

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "reply-kindly",
  "name": "Reply kindly",
  "summary": "Drafts a short, kind reply to a message.",
  "kind": "prompt",
  "input": {
    "type": "object",
    "required": [
      "message"
    ],
    "properties": {
      "message": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "output": {
    "kind": "json",
    "schema": {
      "type": "object",
      "required": [
        "reply"
      ],
      "properties": {
        "reply": {
          "type": "string"
        }
      }
    }
  },
  "prompt": {
    "instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
    "model": "auto",
    "temperature": 0.4,
    "max_tokens": 400
  },
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z"
}
~~~~

Rejected: bad-slug

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "Reply Kindly",
  "name": "Reply kindly",
  "summary": "Drafts a short, kind reply to a message.",
  "kind": "prompt",
  "input": {
    "type": "object",
    "required": [
      "message"
    ],
    "properties": {
      "message": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "output": {
    "kind": "json",
    "schema": {
      "type": "object",
      "required": [
        "reply"
      ],
      "properties": {
        "reply": {
          "type": "string"
        }
      }
    }
  },
  "prompt": {
    "instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
    "model": "auto",
    "temperature": 0.4,
    "max_tokens": 400
  },
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z"
}
~~~~

Rejected: chain-one-step

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "site-check",
  "name": "Site check",
  "summary": "Looks up a domain's DNS, then summarizes it in plain words.",
  "kind": "chain",
  "input": {
    "type": "object",
    "required": [
      "domain"
    ],
    "properties": {
      "domain": {
        "type": "string"
      }
    }
  },
  "output": {
    "kind": "text"
  },
  "prompt": null,
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z",
  "chain": {
    "steps": [
      {
        "tool": "dns",
        "name": "Look up the DNS",
        "input": {
          "target": "{{input.domain}}"
        }
      }
    ]
  }
}
~~~~

Rejected: chain-with-prompt

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "site-check",
  "name": "Site check",
  "summary": "Looks up a domain's DNS, then summarizes it in plain words.",
  "kind": "chain",
  "input": {
    "type": "object",
    "required": [
      "domain"
    ],
    "properties": {
      "domain": {
        "type": "string"
      }
    }
  },
  "output": {
    "kind": "text"
  },
  "prompt": {
    "instructions": "x",
    "model": "auto"
  },
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z",
  "chain": {
    "steps": [
      {
        "tool": "dns",
        "name": "Look up the DNS",
        "input": {
          "target": "{{input.domain}}"
        }
      },
      {
        "tool": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
        "name": "Say it plainly",
        "input": {
          "message": "The DNS of {{input.domain}}: {{steps.0.records}}"
        }
      }
    ],
    "output_from": "last"
  }
}
~~~~

Rejected: json-without-schema

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "reply-kindly",
  "name": "Reply kindly",
  "summary": "Drafts a short, kind reply to a message.",
  "kind": "prompt",
  "input": {
    "type": "object",
    "required": [
      "message"
    ],
    "properties": {
      "message": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "output": {
    "kind": "json"
  },
  "prompt": {
    "instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
    "model": "auto",
    "temperature": 0.4,
    "max_tokens": 400
  },
  "code": null,
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z"
}
~~~~

Rejected: prompt-with-code

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "reply-kindly",
  "name": "Reply kindly",
  "summary": "Drafts a short, kind reply to a message.",
  "kind": "prompt",
  "input": {
    "type": "object",
    "required": [
      "message"
    ],
    "properties": {
      "message": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "output": {
    "kind": "json",
    "schema": {
      "type": "object",
      "required": [
        "reply"
      ],
      "properties": {
        "reply": {
          "type": "string"
        }
      }
    }
  },
  "prompt": {
    "instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
    "model": "auto",
    "temperature": 0.4,
    "max_tokens": 400
  },
  "code": {
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "entry": "tool.js"
  },
  "net": "deny",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z"
}
~~~~

Rejected: prompt-with-network

~~~~
{
  "id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
  "owner": {
    "subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
    "name": "Ada"
  },
  "slug": "reply-kindly",
  "name": "Reply kindly",
  "summary": "Drafts a short, kind reply to a message.",
  "kind": "prompt",
  "input": {
    "type": "object",
    "required": [
      "message"
    ],
    "properties": {
      "message": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "output": {
    "kind": "json",
    "schema": {
      "type": "object",
      "required": [
        "reply"
      ],
      "properties": {
        "reply": {
          "type": "string"
        }
      }
    }
  },
  "prompt": {
    "instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
    "model": "auto",
    "temperature": 0.4,
    "max_tokens": 400
  },
  "code": null,
  "net": "public",
  "hosting": "openvibe",
  "visibility": "public",
  "version": 3,
  "run": {
    "method": "POST",
    "path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
  },
  "runs": 12,
  "created_at": "2026-11-15T17:00:00.000Z",
  "updated_at": "2026-11-15T17:40:00.000Z"
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('tools.made-tool@1', value);   // { valid, errors: [{ path, message }] }
~~~~
