Nodehour: GPU capacity sized from your run and quoted by providers is an MCP server published by com.forevenza.services, hosted at nodehour.forevenza.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 18 tools, including describe_business, submit_request, interpret_requirement, get_requirement, edit_requirement.
GPU cluster sourcing: describe the run, get a sized requirement, quotes compared by email
65 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
What Nodehour does (GPU capacity sized from your run and quoted by providers: Describe the training run or serving fleet. Nodehour sizes the cluster, takes one requirement to providers that can run it, and returns options side by side to choose from.), what happens to a request, what you receive, its price basis (a verified price, an estimate, a method or a scoped quotation; never an offer), when a reply is due, who the buyer contracts with and who invoices, its scope, and the request fields with examples.
No parameters.
{
"name": "describe_business",
"title": "About Nodehour",
"description": "What Nodehour does (GPU capacity sized from your run and quoted by providers: Describe the training run or serving fleet. Nodehour sizes the cluster, takes one requirement to providers that can run it, and returns options side by side to choose from.), what happens to a request, what you receive, its price basis (a verified price, an estimate, a method or a scoped quotation; never an offer), when a reply is due, who the buyer contracts with and who invoices, its scope, and the request fields with examples.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Send Nodehour a requirement (GPU capacity sized from your run and quoted by providers). You get a reference number at once, and we keep exactly what you sent: your words, the proposed configuration, the terms to quote and the open questions. If sizing or an open question changes the quote we email you first; then we take the configuration to providers that can run it, ask each to quote the same terms, and send the options side by side to the address you left. Without an address no one can reply, and nothing goes to providers until you add one. Nothing is priced, held or ordered until you accept an option's terms with the provider. Contact details are deleted after 180 days. It is answered with a receipt: keep its id and token to read its status (request_status), to add details later (continuation) and to act on an offer made in reply. A requirement is not an order and costs nothing.
| Parameter | Type | Description |
|---|---|---|
| need * | string | The requirement in the buyer's own words |
| action | string | one of ["buy","source","quote","verify","lease","license","hire","retrieve","convert","other"] |
| budget | object | |
| timing | object | |
| contact | object | |
| quantity | object | |
| geography | object | |
| continuation | object | The receipt id and token of an earlier request, to add to it instead of opening a new one |
| specifications | object | Fields from the request_schema describe_business returns |
| requested_fields | array |
{
"name": "submit_request",
"title": "Send Nodehour a requirement",
"description": "Send Nodehour a requirement (GPU capacity sized from your run and quoted by providers). You get a reference number at once, and we keep exactly what you sent: your words, the proposed configuration, the terms to quote and the open questions. If sizing or an open question changes the quote we email you first; then we take the configuration to providers that can run it, ask each to quote the same terms, and send the options side by side to the address you left. Without an address no one can reply, and nothing goes to providers until you add one. Nothing is priced, held or ordered until you accept an option's terms with the provider. Contact details are deleted after 180 days. It is answered with a receipt: keep its id and token to read its status (request_status), to add details later (continuation) and to act on an offer made in reply. A requirement is not an order and costs nothing.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"need"
],
"properties": {
"need": {
"type": "string",
"maxLength": 2000,
"description": "The requirement in the buyer's own words"
},
"action": {
"enum": [
"buy",
"source",
"quote",
"verify",
"lease",
"license",
"hire",
"retrieve",
"convert",
"other"
],
"type": "string"
},
"budget": {
"type": "object",
"required": [
"amount"
],
"properties": {
"per": {
"type": "string"
},
"amount": {
"type": "number"
},
"currency": {
"type": "string"
}
}
},
"timing": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"latest": {
"type": "string"
},
"earliest": {
"type": "string"
},
"recurrence": {
"type": "string"
}
}
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"organization": {
"type": "string"
}
}
},
"quantity": {
"type": "object",
"required": [
"amount",
"unit"
],
"properties": {
"per": {
"type": "string"
},
"unit": {
"type": "string"
},
"amount": {
"type": "number"
}
}
},
"geography": {
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"text": {
"type": "string"
},
"country": {
"type": "string"
}
}
},
"continuation": {
"type": "object",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$"
}
},
"description": "The receipt id and token of an earlier request, to add to it instead of opening a new one"
},
"specifications": {
"type": "object",
"description": "Fields from the request_schema describe_business returns",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"requested_fields": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Give Nodehour the buyer's requirement, or a correction or addition to it, in their own words: it is read into a structured requirement (each value says which words it came from), conflicting or unclear facts come back as one question, and words not yet read are kept as written. Pass the requirement (id, token) from the first answer to continue it. Nothing is sent or ordered: send_requirement sends it when the buyer says so. When you already have the fields in structured form, use submit_request instead.
| Parameter | Type | Description |
|---|---|---|
| turn_id | string | Your id for this message: a retry with the same id is applied once |
| timezone | string | The buyer's IANA time zone, for reading dates |
| utterance * | string | The buyer's words, as written |
| requirement | object | The requirement to continue |
{
"name": "interpret_requirement",
"title": "Describe a need to Nodehour in words",
"description": "Give Nodehour the buyer's requirement, or a correction or addition to it, in their own words: it is read into a structured requirement (each value says which words it came from), conflicting or unclear facts come back as one question, and words not yet read are kept as written. Pass the requirement (id, token) from the first answer to continue it. Nothing is sent or ordered: send_requirement sends it when the buyer says so. When you already have the fields in structured form, use submit_request instead.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"utterance"
],
"properties": {
"turn_id": {
"type": "string",
"maxLength": 80,
"description": "Your id for this message: a retry with the same id is applied once"
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "The buyer's IANA time zone, for reading dates"
},
"utterance": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The buyer's words, as written"
},
"requirement": {
"type": "object",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The requirement id from an earlier answer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Its private token (also the receipt token of the request it is sent as); keep it private"
}
},
"description": "The requirement to continue"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}A Nodehour requirement as it stands: each value with where it came from, what it replaced, the open question, words not yet read, whether it was sent and any offer on it.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The requirement id from an earlier answer |
| token * | string | Its private token (also the receipt token of the request it is sent as); keep it private |
{
"name": "get_requirement",
"title": "Read a requirement as it stands",
"description": "A Nodehour requirement as it stands: each value with where it came from, what it replaced, the open question, words not yet read, whether it was sent and any offer on it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The requirement id from an earlier answer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Its private token (also the receipt token of the request it is sent as); keep it private"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Set fields by name ({"op":"set","values":{...}}, an empty value clears) or change the list ({"op":"add"|"update"|"remove"|"replace", ...}), exactly as given: no reading. Use it to answer the open question when the answer is a value.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The requirement id from an earlier answer |
| ops * | array | |
| op_id | string | |
| token * | string | Its private token (also the receipt token of the request it is sent as); keep it private |
| base_revision | integer |
{
"name": "edit_requirement",
"title": "Change a requirement by field",
"description": "Set fields by name ({\"op\":\"set\",\"values\":{...}}, an empty value clears) or change the list ({\"op\":\"add\"|\"update\"|\"remove\"|\"replace\", ...}), exactly as given: no reading. Use it to answer the open question when the answer is a value.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"ops"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The requirement id from an earlier answer"
},
"ops": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"maxItems": 30,
"minItems": 1
},
"op_id": {
"type": "string",
"maxLength": 80
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Its private token (also the receipt token of the request it is sent as); keep it private"
},
"base_revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send the requirement to Nodehour once the buyer says to: the first send records the request (its receipt token is the requirement's token, for request_status and offers); a later send of a changed requirement records a revision of the same request. Name the revision the buyer saw. This orders nothing: an offer comes later and is accepted separately on its exact terms.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The requirement id from an earlier answer |
| op_id | string | |
| token * | string | Its private token (also the receipt token of the request it is sent as); keep it private |
| action | string | What the buyer wants done (default quote): to buy, lease, verify... |
| contact | object | |
| revision * | integer |
{
"name": "send_requirement",
"title": "Send the requirement",
"description": "Send the requirement to Nodehour once the buyer says to: the first send records the request (its receipt token is the requirement's token, for request_status and offers); a later send of a changed requirement records a revision of the same request. Name the revision the buyer saw. This orders nothing: an offer comes later and is accepted separately on its exact terms.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"revision"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The requirement id from an earlier answer"
},
"op_id": {
"type": "string",
"maxLength": 80
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Its private token (also the receipt token of the request it is sent as); keep it private"
},
"action": {
"enum": [
"buy",
"source",
"quote",
"verify",
"lease",
"license",
"hire",
"retrieve",
"convert",
"other"
],
"type": "string",
"description": "What the buyer wants done (default quote): to buy, lease, verify..."
},
"contact": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 200
},
"organization": {
"type": "string",
"maxLength": 160
}
}
},
"revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resume a requirement using the receipt credentials. Read the recorded requirement, any replies the business has published on it (messages: where it answers a buyer with no email, it answers here) and any linked offers. Answer a reply by sending a continuation. Contact details are kept apart.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
{
"name": "request_status",
"title": "Check a request and its offers",
"description": "Resume a requirement using the receipt credentials. Read the recorded requirement, any replies the business has published on it (messages: where it answers a buyer with no email, it answers here) and any linked offers. Answer a reply by sending a continuation. Contact details are kept apart.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read the exact authorized terms, terms hash, order state and processor payment links, and the thread the business published on the offer: its answers to counteroffers (thread.counteroffers), the purchasing requirements, vendor status and purchase order matches it holds (thread.purchasing), and the portions, shortfall and remedies of delivery (thread.fulfilment). Use the offer link credentials, or credentials of the request explicitly linked to this offer.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
{
"name": "inspect_offer",
"title": "Inspect an offer's terms and thread",
"description": "Read the exact authorized terms, terms hash, order state and processor payment links, and the thread the business published on the offer: its answers to counteroffers (thread.counteroffers), the purchasing requirements, vendor status and purchase order matches it holds (thread.purchasing), and the portions, shortfall and remedies of delivery (thread.fulfilment). Use the offer link credentials, or credentials of the request explicitly linked to this offer.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Place an order on terms you have inspected and the buyer has authorized you to accept. Requires the exact terms hash and explicit acceptance. Follow inspect_offer later for payment links and verified payment state.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| accept * | boolean | |
| organization | string | |
| terms_sha256 * | string | |
| purchase_order | string |
{
"name": "accept_offer",
"title": "Accept an offer and place the order",
"description": "Place an order on terms you have inspected and the buyer has authorized you to accept. Requires the exact terms hash and explicit acceptance. Follow inspect_offer later for payment links and verified payment state.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"accept",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"accept": {
"type": "boolean",
"const": true
},
"organization": {
"type": "string",
"maxLength": 160
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"purchase_order": {
"type": "string",
"maxLength": 80
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Decline an issued offer on its inspected terms.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| reason | string | |
| terms_sha256 * | string |
{
"name": "decline_offer",
"title": "Decline an offer",
"description": "Decline an issued offer on its inspected terms.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"reason": {
"type": "string",
"maxLength": 500
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Confirm a payment condition only where the inspected order allows the customer to release it. This records approval; it does not pay the processor.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name | string | |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| confirm * | boolean | |
| payment * | string | |
| terms_sha256 * | string |
{
"name": "release_payment",
"title": "Release a payment condition",
"description": "Confirm a payment condition only where the inspected order allows the customer to release it. This records approval; it does not pay the processor.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"payment",
"confirm"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"confirm": {
"type": "boolean",
"const": true
},
"payment": {
"type": "string",
"maxLength": 100
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve what a paid order delivers, where the business produces it itself (a report): the exact text, its SHA-256, version, sources and any shortfall. Before payment is confirmed it says it is not yet available. Use the offer link or linked request credentials.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
{
"name": "retrieve_deliverable",
"title": "Retrieve a paid order's deliverable",
"description": "Retrieve what a paid order delivers, where the business produces it itself (a report): the exact text, its SHA-256, version, sources and any shortfall. Before payment is confirmed it says it is not yet available. Use the offer link or linked request credentials.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Propose a change to an issued offer on its inspected terms: other quantities (by item index in terms.items), another list of companies (where the items price companies), a delivery date, a total price for the whole, a payment plan, or a note. It is a proposal, not a change: the terms stand and can still be accepted as they are. The business answers it in inspect_offer thread.counteroffers, with a revised offer to inspect and accept, or a reason. A later proposal replaces an earlier one still awaiting an answer. Nothing here orders or pays.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | Name of the person making this for the buyer |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| proposal * | object | At least one of quantities, counterparties, deliver_by, total_minor, payment or note |
| organization | string | The buyer's organization |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
{
"name": "counter_offer",
"title": "Propose changes to an offer",
"description": "Propose a change to an issued offer on its inspected terms: other quantities (by item index in terms.items), another list of companies (where the items price companies), a delivery date, a total price for the whole, a payment plan, or a note. It is a proposal, not a change: the terms stand and can still be accepted as they are. The business answers it in inspect_offer thread.counteroffers, with a revised offer to inspect and accept, or a reason. A later proposal replaces an earlier one still awaiting an answer. Nothing here orders or pays.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"proposal",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"proposal": {
"type": "object",
"properties": {
"note": {
"type": "string",
"maxLength": 1000
},
"payment": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"CHECKOUT_FULL",
"INVOICE"
],
"type": "string"
},
"days_until_due": {
"type": "integer",
"maximum": 90,
"minimum": 0
}
}
},
"deliver_by": {
"type": "string",
"maxLength": 40,
"description": "ISO date, such as 2027-01-15"
},
"quantities": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"item": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "0-based index into terms.items"
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"maxItems": 40,
"minItems": 1
},
"total_minor": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The total the buyer proposes for the whole, in minor units of the offer currency",
"exclusiveMinimum": 0
},
"counterparties": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 160,
"minLength": 2
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166 two-letter code"
},
"identifier": {
"type": "string",
"maxLength": 40,
"description": "An LEI, CIK or registry number, if known"
}
}
},
"maxItems": 25,
"minItems": 1,
"description": "The companies the order should cover instead, for an offer whose items price companies"
}
},
"description": "At least one of quantities, counterparties, deliver_by, total_minor, payment or note"
},
"organization": {
"type": "string",
"maxLength": 160,
"description": "The buyer's organization"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send the buyer's purchase order for an issued offer or a placed order: number, revision, lines, total, currency and payment terms. It is matched against the accepted terms; differences are recorded and shown in inspect_offer thread.purchasing as exceptions, never silently accepted. A changed purchase order is the same number with a higher revision. This does not accept the offer and pays nothing.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| po * | object | |
| name * | string | Name of the person making this for the buyer |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| organization | string | The buyer's organization |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
{
"name": "submit_purchase_order",
"title": "Send a purchase order",
"description": "Send the buyer's purchase order for an issued offer or a placed order: number, revision, lines, total, currency and payment terms. It is matched against the accepted terms; differences are recorded and shown in inspect_offer thread.purchasing as exceptions, never silently accepted. A changed purchase order is the same number with a higher revision. This does not accept the offer and pays nothing.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"po",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"po": {
"type": "object",
"required": [
"number",
"lines",
"total_minor",
"currency",
"payment_terms_days"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"quantity",
"unit_price_minor",
"amount_minor"
],
"properties": {
"quantity": {
"type": "number",
"minimum": 0
},
"description": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"amount_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "quantity times unit_price_minor"
},
"unit_price_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"maxItems": 40,
"minItems": 1
},
"number": {
"type": "string",
"pattern": "^[A-Za-z0-9._/-]{1,60}$"
},
"bill_to": {
"type": "string",
"maxLength": 300
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1 unless this replaces an earlier revision"
},
"total_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"invoice_route": {
"type": "string",
"maxLength": 300,
"description": "Where invoices go: a portal URL, email or API"
},
"buyer_vendor_id": {
"type": "string",
"maxLength": 80,
"description": "The seller's vendor id in the buyer's system"
},
"document_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "SHA-256 of the purchase order document, if there is one"
},
"payment_terms_days": {
"type": "integer",
"maximum": 120,
"minimum": 0
}
}
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"organization": {
"type": "string",
"maxLength": 160,
"description": "The buyer's organization"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Tell the business how the buyer's purchasing works for this offer: whether the seller must be an approved vendor, whether a purchase order is required, which documents are needed, the seller's vendor id with the buyer, where orders and invoices go, and the payment terms. Recorded as the buyer's statement; the business answers it in inspect_offer thread.purchasing. Nothing here orders or pays.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | Name of the person making this for the buyer |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| organization * | string | The buyer's organization, whose purchasing this is |
| requirements * | object | |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
{
"name": "state_purchasing_requirements",
"title": "State the buyer's purchasing requirements",
"description": "Tell the business how the buyer's purchasing works for this offer: whether the seller must be an approved vendor, whether a purchase order is required, which documents are needed, the seller's vendor id with the buyer, where orders and invoices go, and the payment terms. Recorded as the buyer's statement; the business answers it in inspect_offer thread.purchasing. Nothing here orders or pays.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"requirements",
"name",
"organization"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"organization": {
"type": "string",
"maxLength": 160,
"minLength": 2,
"description": "The buyer's organization, whose purchasing this is"
},
"requirements": {
"type": "object",
"required": [
"vendor_approval_required",
"purchase_order_required",
"documents_required"
],
"properties": {
"note": {
"type": "string",
"maxLength": 1000
},
"route": {
"type": "string",
"maxLength": 300,
"description": "How the buyer's purchasing takes orders and invoices: a portal URL, email or API"
},
"buyer_vendor_id": {
"type": "string",
"maxLength": 80
},
"documents_required": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 12,
"description": "Documents the buyer's purchasing needs from the seller, such as a W-9 or an insurance certificate"
},
"payment_terms_days": {
"type": "integer",
"maximum": 120,
"minimum": 0
},
"purchase_order_required": {
"type": "boolean"
},
"vendor_approval_required": {
"type": "boolean"
}
}
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Report the seller's vendor standing with the buyer's organization (APPROVED, DOCUMENTS_REQUESTED or REJECTED) with the buyer's approval or case reference and any documents requested. Recorded as the buyer's own statement; the business answers it in inspect_offer thread.purchasing.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | Name of the person making this for the buyer |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| status * | string | one of ["APPROVED","DOCUMENTS_REQUESTED","REJECTED"] |
| reference * | string | The buyer's approval or case reference |
| organization * | string | The buyer's organization |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
| buyer_vendor_id | string | |
| documents_requested | array |
{
"name": "report_vendor_status",
"title": "Report vendor approval status",
"description": "Report the seller's vendor standing with the buyer's organization (APPROVED, DOCUMENTS_REQUESTED or REJECTED) with the buyer's approval or case reference and any documents requested. Recorded as the buyer's own statement; the business answers it in inspect_offer thread.purchasing.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"status",
"reference",
"name",
"organization"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"status": {
"enum": [
"APPROVED",
"DOCUMENTS_REQUESTED",
"REJECTED"
],
"type": "string"
},
"reference": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "The buyer's approval or case reference"
},
"organization": {
"type": "string",
"maxLength": 160,
"minLength": 2,
"description": "The buyer's organization"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
},
"buyer_vendor_id": {
"type": "string",
"maxLength": 80
},
"documents_requested": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 12
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Record the buyer's inspection of a placed order: for each item (its index in terms.items) the quantity accepted and the quantity rejected, with a reason for a rejection, optionally for one portion of the order. Whether it was accepted is computed: only when nothing is rejected. Recorded for the business, which answers a rejection in inspect_offer thread.fulfilment, with a proposed remedy. Nothing here pays or refunds.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | Name of the person making this for the buyer |
| note | string | |
| lines * | array | |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| portion | string | The portion inspected, as thread.fulfilment.portions names it |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
{
"name": "inspect_delivery",
"title": "Record a delivery inspection",
"description": "Record the buyer's inspection of a placed order: for each item (its index in terms.items) the quantity accepted and the quantity rejected, with a reason for a rejection, optionally for one portion of the order. Whether it was accepted is computed: only when nothing is rejected. Recorded for the business, which answers a rejection in inspect_offer thread.fulfilment, with a proposed remedy. Nothing here pays or refunds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"lines",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"note": {
"type": "string",
"maxLength": 1000
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"accepted_quantity",
"rejected_quantity"
],
"properties": {
"item": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "0-based index into terms.items"
},
"reason": {
"type": "string",
"maxLength": 300
},
"accepted_quantity": {
"type": "number",
"minimum": 0
},
"rejected_quantity": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 40,
"minItems": 1
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"portion": {
"type": "string",
"maxLength": 40,
"description": "The portion inspected, as thread.fulfilment.portions names it"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Accept or decline a remedy the business proposed on a placed order (inspect_offer thread.fulfilment.remedies with state PROPOSED). Recorded for the business, which applies it and shows the result there. Accepting a credit or refund here moves no money; the business records it when its payment processor does.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The request or offer id from your receipt or customer link |
| name * | string | Name of the person making this for the buyer |
| note | string | |
| token * | string | Private token from your receipt or customer link; keep it for later visits |
| answer * | string | one of ["ACCEPT","DECLINE"] |
| remedy_id * | string | |
| terms_sha256 * | string | Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since |
{
"name": "answer_remedy",
"title": "Answer a proposed remedy",
"description": "Accept or decline a remedy the business proposed on a placed order (inspect_offer thread.fulfilment.remedies with state PROPOSED). Recorded for the business, which applies it and shows the result there. Accepting a credit or refund here moves no money; the business records it when its payment processor does.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"token",
"terms_sha256",
"remedy_id",
"answer",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The request or offer id from your receipt or customer link"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the person making this for the buyer"
},
"note": {
"type": "string",
"maxLength": 1000
},
"token": {
"type": "string",
"pattern": "^[0-9a-f]{48}$",
"description": "Private token from your receipt or customer link; keep it for later visits"
},
"answer": {
"enum": [
"ACCEPT",
"DECLINE"
],
"type": "string"
},
"remedy_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact terms_sha256 from inspect_offer; the act is refused if the terms have changed since"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}A buyer can describe a training run, fine-tune or serving target in plain words (model size, tokens or tokens/s, start, deadline, region, stack) or give a known cluster spec. The page proposes a configuration with its GPU-hours arithmetic, one alternative and the decisions that change the quote, then sends the requirement. Each request gets a reference at once; Nodehour takes the configuration to providers, asks each to quote the same terms and replies by email with options side by side. Nothing is priced, held or ordered until the buyer accepts an option's terms with the provider. Agents can POST the same envelope to /_c/request; date fields are whole numbers YYYYMMDD and anything else in them is refused with HTTP 400 naming the field; a request without contact.email and specifications.reply_email_included: true comes back with reply_email_included in missing_specifications, because no one can reply to it. Use describe_business, then submit_request with structured fields, or interpret_requirement with the buyer's own words.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.