docs.vin

mco

The mco noun — identity, lifecycle, events, and every capability as an anchored section: 8 capabilities, 0 live, 8 sandbox, 0 declared.

mco is one of the estate's 317 automotive nouns — a job a car needs done. It carries 8 capabilities: 0 live, 8 sandbox, 0 declared · doors aggregator.vin.

Identity

Nounmco
PillarData (facets: 3 data · 3 services · 2 commerce)
Capabilities8 — 0 live · 8 sandbox · 0 declared
EntitiesTitle
Doorsaggregator.vin
SDKVin.mco.* from apis.vin
Address/catalog/mco#{action} — the anchor IS the wire name minus mco.

Events

The vocabulary this noun can append to the record — 13 past-tense, versioned event types, each linked to the capability that emits it:

Discover & read

status

mco.status · GET /mcos/status · gate none · sandbox · answers McoStatus@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — mco.status
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.status({"vin":"1FBAX2CM3KKA94316"})
GET /mcos/status
curl 'https://apis.vin/mcos/status?vin=1FBAX2CM3KKA94316'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.165Z · HTTP 200
{
  "type": "OK",
  "answers": "McoStatus@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "certificate": {
      "standing": "surrendered",
      "titlePosition": "Ordered"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "certificate": {
      "standing": "surrendered",
      "titlePosition": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

verify

mco.verify · GET /mcos/verify · gate none · sandbox · answers McoVerify@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — mco.verify
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.verify({"vin":"1FBAX2CM3KKA94316"})
GET /mcos/verify
curl 'https://apis.vin/mcos/verify?vin=1FBAX2CM3KKA94316'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.173Z · HTTP 200
{
  "type": "OK",
  "answers": "McoVerify@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "verification": {
      "verified": true,
      "status": "superseded-by-title",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "verification": {
      "verified": true,
      "status": "superseded-by-title",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

fee

mco.fee · POST /mcos/fee · gate offer · sandbox · answers McoFee@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.feeCharged@1 · Mco.feeRequested@1.

the SDK — mco.fee
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.fee({"vin":"1FBAX2CM3KKA94316"})
POST /mcos/fee
curl -X POST https://apis.vin/mcos/fee \
  -H 'content-type: application/json' \
  -d '{"vin":"1FBAX2CM3KKA94316"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.155Z · HTTP 200
{
  "type": "OK",
  "answers": "McoFee@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "fee": {
      "status": "no-certificate-fee-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "fee": {
      "status": "no-certificate-fee-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

assign

mco.assign · POST /mcos/assign · gate offer · sandbox · answers McoAssign@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.assignRequested@1 · Mco.assigned@1.

the SDK — mco.assign
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.assign({"vin":"1FBAX2CM3KKA94316"})
POST /mcos/assign
curl -X POST https://apis.vin/mcos/assign \
  -H 'content-type: application/json' \
  -d '{"vin":"1FBAX2CM3KKA94316"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.146Z · HTTP 200
{
  "type": "OK",
  "answers": "McoAssign@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "assignment": {
      "status": "already-converted",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "assignment": {
      "status": "already-converted",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

mco.pay · POST /mcos/pay · gate offer · sandbox · answers McoPay@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.paid@1 · Mco.payFailed@1 · Mco.payRequested@1.

the SDK — mco.pay
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.pay({"vin":"1FBAX2CM3KKA94316"})
POST /mcos/pay
curl -X POST https://apis.vin/mcos/pay \
  -H 'content-type: application/json' \
  -d '{"vin":"1FBAX2CM3KKA94316"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.156Z · HTTP 200
{
  "type": "OK",
  "answers": "McoPay@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "payment": {
      "status": "no-certificate-fee-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "payment": {
      "status": "no-certificate-fee-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

convert

mco.convert · POST /mcos/convert · gate offer · sandbox · answers McoConvert@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.convertFailed@1 · Mco.convertRequested@1 · Mco.converted@1.

the SDK — mco.convert
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.convert({"vin":"1FBAX2CM3KKA94316"})
POST /mcos/convert
curl -X POST https://apis.vin/mcos/convert \
  -H 'content-type: application/json' \
  -d '{"vin":"1FBAX2CM3KKA94316"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.146Z · HTTP 200
{
  "type": "OK",
  "answers": "McoConvert@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "conversion": {
      "status": "conversion-in-progress",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "conversion": {
      "status": "conversion-in-progress",
      "titleId": "TTL-36d18102",
      "titlePosition": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

custody

mco.custody · GET /mcos/custody · gate none · sandbox · answers McoCustody@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.custodyTracked@1.

the SDK — mco.custody
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.custody({"vin":"1FBAX2CM3KKA94316"})
GET /mcos/custody
curl 'https://apis.vin/mcos/custody?vin=1FBAX2CM3KKA94316'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.146Z · HTTP 200
{
  "type": "OK",
  "answers": "McoCustody@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "custody": {
      "status": "surrendered-to-authority",
      "titlePosition": "Ordered"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "custody": {
      "status": "surrendered-to-authority",
      "titlePosition": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

receive

mco.receive · POST /mcos/receive · gate offer · sandbox · answers McoReceive@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FBAX2CM3KKA94316 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Mco.receiveRequested@1 · Mco.received@1.

the SDK — mco.receive
import { mco } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mco.receive({"vin":"1FBAX2CM3KKA94316"})
POST /mcos/receive
curl -X POST https://apis.vin/mcos/receive \
  -H 'content-type: application/json' \
  -d '{"vin":"1FBAX2CM3KKA94316"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:14.159Z · HTTP 200
{
  "type": "OK",
  "answers": "McoReceive@1",
  "value": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "receipt": {
      "status": "already-converted",
      "titleId": "TTL-36d18102"
    }
  },
  "evidence": {
    "vin": "1FBAX2CM3KKA94316",
    "noun": "mco",
    "asOf": "2026-08-10",
    "titleId": "TTL-36d18102",
    "state": "AZ",
    "brands": [
      "salvage"
    ],
    "docType": "MCO",
    "status": "Ordered",
    "receipt": {
      "status": "already-converted",
      "titleId": "TTL-36d18102"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "title-tail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Data model

The record shape behind this noun — one entity, each property an evidence field. See the whole estate model on the data model page.

Title

Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.

maintenance

The maintenance noun — identity, lifecycle, events, and every capability as an anchored section: 24 capabilities, 0 live, 24 sandbox, 0 declared.

mcp

The mcp noun — identity, lifecycle, events, and every capability as an anchored section: 3 capabilities, 0 live, 3 sandbox, 0 declared.

On this page

Identity
Events
Discover & read
status
verify
Quote & price
fee
Apply & book
assign
Pay & settle
pay
More actions
convert
custody
receive
Data model
Title