Server definition
- Hash
- sha256:907fc096cea76814c17c3d220e9a36231d12e79dcaf32b750fe47a081c166bba
- What it is
- What a remote MCP server returned when asked what it offers: 23 tools
The blob, as servednamed by its sha256
{
"instructions": "NodNod gives an AI agent a body: a face, a voice and a brain, sent to a meeting or a web page. New here? Call sign_up with your human owner's email; your key is attached to this connection. Ask your owner for the six digit code NodNod emails them and call verify_owner. Then create_nod and send_nod with to \"page\". Full guide: /llms.txt",
"tools": [
{
"description": "Makes a new key on your own account, for example a narrower one for a helper. scopes defaults to the calling key's scopes and may never be wider. Works in trial (up to 5 live keys); while the owner has not verified, every key is still cut to trial scopes. The secret is returned once: store it. space \"team\" makes a team key (teams only): it is revoked if you leave the team.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scopes": {
"items": {
"enum": [
"account:read",
"nods:read",
"nods:write",
"nods:send",
"keys:read",
"keys:write",
"usage:read"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"space": {
"description": "\"personal\" (the default): yours, and it goes where you go. \"team\": made in your team's space; it stays with the team if you leave, and a team key is revoked when you do.",
"enum": [
"personal",
"team"
],
"type": "string"
}
},
"required": [
"label"
],
"type": "object"
},
"name": "create_key",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"api_key": {
"description": "Store it now. It is never shown again.",
"type": "string"
},
"created_at": {
"type": "string"
},
"id": {
"type": "string"
},
"is_this_key": {
"type": "boolean"
},
"label": {
"type": "string"
},
"last_used_at": {
"type": [
"string",
"null"
]
},
"prefix": {
"description": "The first characters of the key, to tell keys apart. The secret is never shown again.",
"type": "string"
},
"revoked_at": {
"type": [
"string",
"null"
]
},
"scopes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"label",
"prefix",
"scopes",
"created_at",
"last_used_at",
"revoked_at",
"is_this_key",
"api_key"
],
"type": "object"
}
},
{
"description": "Makes a new Nod. Only name is required; parts left out use \"default\". It starts private. A trial account may hold 3 Nods. space \"team\" makes it in your team's space (teams only).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"abilities": {
"description": "Built-in abilities to switch on.",
"items": {
"enum": [
"catch_up",
"remember",
"look_at_screen",
"meeting_history",
"present_deck",
"magic_trick",
"sing"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
"brain": {
"description": "A brain id from list_parts, or \"default\".",
"type": "string"
},
"brain_tier": {
"description": "fast (the default) or big.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"face": {
"description": "A face id from list_parts, or \"default\".",
"type": "string"
},
"face_id": {
"description": "The avatar for the outside-anam face: your own Anam avatar id (your Anam key, added in Studio, pays), or a nodnod: id from list_faces. \"\" for none.",
"maxLength": 64,
"type": "string"
},
"name": {
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"personality": {
"description": "Who the Nod is and how it talks, in plain words.",
"maxLength": 4000,
"type": "string"
},
"slug": {
"description": "The last part of the page address, <web>/<handle>/<slug>. Made from the name if left out.",
"pattern": "^[a-z0-9][a-z0-9-]{0,39}$",
"type": "string"
},
"space": {
"description": "\"personal\" (the default): yours, and it goes where you go. \"team\": made in your team's space; it stays with the team if you leave, and a team key is revoked when you do.",
"enum": [
"personal",
"team"
],
"type": "string"
},
"voice": {
"description": "A voice id from list_parts, or \"default\".",
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part, from list_parts or the catalogue (am_fenrir, bf_emma...). \"\" for its default.",
"pattern": "^[A-Za-z0-9_.-]{0,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"abilities": {
"description": "The built-in abilities switched on.",
"items": {
"type": "string"
},
"type": "array"
},
"audience": {
"enum": [
"private",
"invited",
"public"
],
"type": "string"
},
"brain": {
"type": "string"
},
"brain_tier": {
"description": "fast: quick answers; big: slower and deeper.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"created_at": {
"type": "string"
},
"face": {
"type": "string"
},
"face_id": {
"description": "The avatar inside the face: an Anam avatar id on your own Anam account, or a nodnod: id from list_faces.",
"type": "string"
},
"id": {
"type": "string"
},
"is_paused": {
"type": "boolean"
},
"name": {
"type": "string"
},
"page_url": {
"description": "The Nod's page address; null until your owner picks an account address in NodNod Studio.",
"type": [
"string",
"null"
]
},
"personality": {
"type": "string"
},
"slug": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"voice": {
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part (a Kokoro voice such as am_fenrir); \"\" for its default.",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"personality",
"face",
"face_id",
"voice",
"voice_id",
"brain",
"brain_tier",
"abilities",
"audience",
"is_paused",
"page_url",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "Deletes the Nod: it leaves list_nods, and its page and embed answer not found. Its sessions, charges and history are kept. A Nod live in a room right now is refused (conflict): stop its session first, then delete. Deleting cannot be undone through the API.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"is_deleted": {
"const": true,
"type": "boolean"
},
"message": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"is_deleted",
"message"
],
"type": "object"
}
},
{
"description": "Shows whether the owner has verified, your handle, and the scopes this key holds right now.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_account",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"display_name": {
"type": "string"
},
"handle": {
"description": "The account address; null until your owner picks one in NodNod Studio.",
"type": [
"string",
"null"
]
},
"is_verified": {
"type": "boolean"
},
"owner_email": {
"type": "string"
},
"owner_id": {
"type": "string"
},
"page_base_url": {
"description": "Where this account's pages live; null while handle is null.",
"type": [
"string",
"null"
]
},
"scopes": {
"description": "What the key you called with may do right now.",
"items": {
"type": "string"
},
"type": "array"
},
"trial_max_nods": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"owner_id",
"owner_email",
"display_name",
"handle",
"is_verified",
"scopes",
"trial_max_nods",
"page_base_url"
],
"type": "object"
}
},
{
"description": "Money available for running Nods, in micro-dollars (1 USD = 1,000,000) and as dollars, with one plain line that says why when it is zero.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_balance",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"available_micro_usd": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"available_usd": {
"type": "string"
},
"empty_reason": {
"anyOf": [
{
"enum": [
"unconfirmed",
"link_pending",
"address_used",
"trial_ended"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "unconfirmed: the owner has not confirmed yet. link_pending: the owner gave you the code (you may send) but the mailbox is not proved yet; the owner signs in to Studio once and the free credit follows. address_used: the free credit for this email went to another account. trial_ended: the free trial is over; the owner adds credit to keep going."
},
"is_unlimited": {
"type": "boolean"
},
"message": {
"description": "One plain line about this balance.",
"type": "string"
}
},
"required": [
"available_micro_usd",
"available_usd",
"is_unlimited",
"empty_reason",
"message"
],
"type": "object"
}
},
{
"description": "One Nod by id.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"abilities": {
"description": "The built-in abilities switched on.",
"items": {
"type": "string"
},
"type": "array"
},
"audience": {
"enum": [
"private",
"invited",
"public"
],
"type": "string"
},
"brain": {
"type": "string"
},
"brain_tier": {
"description": "fast: quick answers; big: slower and deeper.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"created_at": {
"type": "string"
},
"face": {
"type": "string"
},
"face_id": {
"description": "The avatar inside the face: an Anam avatar id on your own Anam account, or a nodnod: id from list_faces.",
"type": "string"
},
"id": {
"type": "string"
},
"is_paused": {
"type": "boolean"
},
"name": {
"type": "string"
},
"page_url": {
"description": "The Nod's page address; null until your owner picks an account address in NodNod Studio.",
"type": [
"string",
"null"
]
},
"personality": {
"type": "string"
},
"slug": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"voice": {
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part (a Kokoro voice such as am_fenrir); \"\" for its default.",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"personality",
"face",
"face_id",
"voice",
"voice_id",
"brain",
"brain_tier",
"abilities",
"audience",
"is_paused",
"page_url",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "Whether the Nod is still in the room, why it left, and what it cost once settled. nod_has_spoken says whether the Nod has actually made a sound in its room (true, false, or 'unknown' when the engine cannot say); warning says what to do when a visitor spoke and the Nod has stayed silent.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_session",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"charged_micro_usd": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"end_reason": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"nod_has_spoken": {
"anyOf": [
{
"type": "boolean"
},
{
"const": "unknown",
"type": "string"
}
]
},
"session_id": {
"type": "string"
},
"state": {
"enum": [
"starting",
"live",
"ended",
"failed"
],
"type": "string"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"session_id",
"state",
"end_reason",
"message",
"charged_micro_usd",
"nod_has_spoken",
"warning"
],
"type": "object"
}
},
{
"description": "API calls by operation and sends by target over the last N days (default 30): page, meeting (an outside Zoom, Teams, Meet or Webex call) and meetingburner_room (a MeetingBurner room).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"days": {
"maximum": 90,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_usage",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"calls_by_operation": {
"additionalProperties": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"sends": {
"additionalProperties": false,
"properties": {
"meeting": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"meetingburner_room": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"page",
"meeting",
"meetingburner_room"
],
"type": "object"
},
"session_seconds": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Null until sessions are metered by the wallet."
},
"since": {
"type": "string"
}
},
"required": [
"since",
"calls_by_operation",
"sends",
"session_seconds"
],
"type": "object"
}
},
{
"description": "The photoreal faces on NodNod's own account that this account may use (most accounts: none yet). To use a face from your own face-service account instead, see \"note\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_faces",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"faces": {
"items": {
"additionalProperties": false,
"properties": {
"face_id": {
"description": "Pass as update_nod face_id, with face \"outside-anam\".",
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"is_usable": {
"description": "False for an older model that shows no video.",
"type": "boolean"
},
"name": {
"type": "string"
}
},
"required": [
"face_id",
"name",
"image_url",
"is_usable"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
}
},
"required": [
"faces",
"note"
],
"type": "object"
}
},
{
"description": "Every key on your account, live and revoked. Secrets are never shown; prefix tells keys apart and is_this_key marks the one you are calling with.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_keys",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"keys": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"id": {
"type": "string"
},
"is_this_key": {
"type": "boolean"
},
"label": {
"type": "string"
},
"last_used_at": {
"type": [
"string",
"null"
]
},
"prefix": {
"description": "The first characters of the key, to tell keys apart. The secret is never shown again.",
"type": "string"
},
"revoked_at": {
"type": [
"string",
"null"
]
},
"scopes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"label",
"prefix",
"scopes",
"created_at",
"last_used_at",
"revoked_at",
"is_this_key"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"keys"
],
"type": "object"
}
},
{
"description": "Every Nod on the account that has not been deleted.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_nods",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"nods": {
"items": {
"additionalProperties": false,
"properties": {
"abilities": {
"description": "The built-in abilities switched on.",
"items": {
"type": "string"
},
"type": "array"
},
"audience": {
"enum": [
"private",
"invited",
"public"
],
"type": "string"
},
"brain": {
"type": "string"
},
"brain_tier": {
"description": "fast: quick answers; big: slower and deeper.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"created_at": {
"type": "string"
},
"face": {
"type": "string"
},
"face_id": {
"description": "The avatar inside the face: an Anam avatar id on your own Anam account, or a nodnod: id from list_faces.",
"type": "string"
},
"id": {
"type": "string"
},
"is_paused": {
"type": "boolean"
},
"name": {
"type": "string"
},
"page_url": {
"description": "The Nod's page address; null until your owner picks an account address in NodNod Studio.",
"type": [
"string",
"null"
]
},
"personality": {
"type": "string"
},
"slug": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"voice": {
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part (a Kokoro voice such as am_fenrir); \"\" for its default.",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"personality",
"face",
"face_id",
"voice",
"voice_id",
"brain",
"brain_tier",
"abilities",
"audience",
"is_paused",
"page_url",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"nods"
],
"type": "object"
}
},
{
"description": "The face, voice and brain ids create_nod and update_nod accept from this account, and the default for each. Photoreal faces are in staff preview: an account that is not staff finds them under previews, not ids. tiers are the three presets (Lifelike, Real, Drawn): set face, voice, brain and brain_tier to a tier's ids to use it; Lifelike and Real wear the photoreal face.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_parts",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"parts": {
"items": {
"additionalProperties": false,
"properties": {
"default": {
"type": "string"
},
"ids": {
"description": "The ids this account may pass to create_nod and update_nod.",
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"type": "string"
},
"previews": {
"description": "Ids in staff preview, with whether this account may use them.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"is_open_to_you": {
"type": "boolean"
},
"note": {
"type": "string"
},
"status": {
"const": "staff_preview",
"type": "string"
}
},
"required": [
"id",
"status",
"is_open_to_you",
"note"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"kind",
"default",
"ids",
"previews"
],
"type": "object"
},
"type": "array"
},
"tiers": {
"items": {
"additionalProperties": false,
"properties": {
"brain": {
"type": "string"
},
"brain_tier": {
"enum": [
"fast",
"big"
],
"type": "string"
},
"face": {
"type": "string"
},
"id": {
"type": "string"
},
"line": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"description": "As this account sees it; coming_soon cannot be used yet.",
"enum": [
"available",
"staff_preview",
"coming_soon",
"owner_key_required"
],
"type": "string"
},
"voice": {
"type": "string"
}
},
"required": [
"id",
"name",
"line",
"face",
"voice",
"brain",
"brain_tier",
"status"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"parts",
"tiers"
],
"type": "object"
}
},
{
"description": "Sends a fresh code and link to the owner (the old ones stop working). At most 3 an hour and 6 a day; a letter that could not be sent does not count, but tries are limited to 10 an hour and 20 a day.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "resend_owner_letter",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"sent_to": {
"type": "string"
}
},
"required": [
"sent_to"
],
"type": "object"
}
},
{
"description": "The key stops working at once, on REST and MCP. Only keys on your own account can be revoked. Revoking the key you are calling with is allowed and ends your access, so make a new key first if you need one.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "revoke_key",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"id": {
"type": "string"
},
"is_this_key": {
"type": "boolean"
},
"label": {
"type": "string"
},
"last_used_at": {
"type": [
"string",
"null"
]
},
"prefix": {
"description": "The first characters of the key, to tell keys apart. The secret is never shown again.",
"type": "string"
},
"revoked_at": {
"type": [
"string",
"null"
]
},
"scopes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"label",
"prefix",
"scopes",
"created_at",
"last_used_at",
"revoked_at",
"is_this_key"
],
"type": "object"
}
},
{
"description": "to \"page\" opens the Nod's personal page to visitors (after an automatic leak check) and returns its URL and the embed code; pass embed_origins to let other websites show it. to \"meeting\" with meeting_url (Zoom, Teams, Meet or Webex) sends it into that call as a guest named with \"(AI agent)\" that says it is an AI, listens and speaks only (no tools), one meeting at a time, at the outside-meeting price; the host may have to let it in. to \"meetingburner_room\" with meeting_url (a MeetingBurner room link) sends it into the room as a member with its face and voice, on your own MeetingBurner outside agent key: send it once as meetingburner_key and it is kept. You must be in the room first, and MeetingBurner allows one of your agents on camera at a time. stop_session with the returned session_id brings it home. Needs a verified owner. Outside meetings are not open yet: to \"meeting\" (Zoom, Teams, Meet or Webex) answers not_live here. To \"page\" and to \"meetingburner_room\" are not behind this switch.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"audience": {
"description": "Who may talk to the page: \"public\" (anyone, the default) or \"invited\".",
"enum": [
"public",
"invited"
],
"type": "string"
},
"embed_origins": {
"description": "Websites that may show the embed, e.g. [\"https://example.com\"]. Left out keeps the current list.",
"items": {
"pattern": "^https:\\/\\/[a-z0-9.-]+(:\\d+)?$|^http:\\/\\/localhost(:\\d+)?$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"id": {
"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)$",
"type": "string"
},
"meeting_url": {
"format": "uri",
"type": "string"
},
"meetingburner_key": {
"description": "Your MeetingBurner outside agent key. Needed once; it is kept in a vault and never shown again.",
"maxLength": 400,
"minLength": 16,
"type": "string"
},
"to": {
"enum": [
"page",
"meeting",
"meetingburner_room"
],
"type": "string"
}
},
"required": [
"id",
"to"
],
"type": "object"
},
"name": "send_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"audience": {
"enum": [
"public",
"invited"
],
"type": "string"
},
"embed_code": {
"description": "The one line a website pastes to show this Nod.",
"type": "string"
},
"next_step": {
"type": "string"
},
"probe": {
"additionalProperties": false,
"description": "The red-team check that runs before a page opens. A failed check keeps the page closed.",
"properties": {
"attacks_run": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"findings": {
"items": {
"type": "string"
},
"type": "array"
},
"passed": {
"type": "boolean"
}
},
"required": [
"passed",
"attacks_run",
"findings"
],
"type": "object"
},
"send_id": {
"description": "Null when the page stayed closed (status blocked).",
"type": [
"string",
"null"
]
},
"session_id": {
"description": "For a meeting or a MeetingBurner room: read or stop it with get_session or stop_session.",
"type": "string"
},
"status": {
"enum": [
"live",
"blocked"
],
"type": "string"
},
"to": {
"enum": [
"page",
"meeting",
"meetingburner_room"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"send_id",
"to",
"url",
"status",
"next_step"
],
"type": "object"
}
},
{
"description": "Open to any agent whose human owner is in NodNod's private beta (an invited work email address; any other owner_email is refused with forbidden). Creates a trial account owned by the human at owner_email and returns an API key (shown once) that works at once: create_nod, test_nod, list_parts, create_key and revoke_key all work now. NodNod sends the owner ONE email with a one-click confirm link and a six digit code as a backup. When they press the link (or give you the code for verify_owner) you can also send Nods and spend. On the MCP door the key is attached to your session automatically.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"display_name": {
"description": "Your owner's name, shown on the personal page (\"An AI agent put here by <name>\"). Left out, the page says \"its owner\".",
"maxLength": 80,
"type": "string"
},
"handle": {
"description": "The personal page path, <web>/<handle> (get_account and send_nod give the full address). Made up if left out.",
"pattern": "^[a-z0-9][a-z0-9-]{1,38}$",
"type": "string"
},
"key_label": {
"maxLength": 80,
"type": "string"
},
"owner_email": {
"description": "The human who will be accountable for this account. NodNod emails them one confirm link.",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
}
},
"required": [
"owner_email"
],
"type": "object"
},
"name": "sign_up",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"api_key": {
"description": "Store it now. It is never shown again.",
"type": "string"
},
"can_do_now": {
"description": "Operations this key can call right now.",
"items": {
"type": "string"
},
"type": "array"
},
"handle": {
"type": "string"
},
"is_verified": {
"const": false,
"type": "boolean"
},
"key_id": {
"type": "string"
},
"next_step": {
"type": "string"
},
"owner_id": {
"type": "string"
}
},
"required": [
"api_key",
"key_id",
"owner_id",
"handle",
"is_verified",
"can_do_now",
"next_step"
],
"type": "object"
}
},
{
"description": "Starts the Nod in a fresh room on our GPU, paid from your balance, and returns the room address and a pass that joins it with a microphone (LiveKit). The Nod says it is an AI agent, then answers. It leaves when you stop it, when the room is empty for a minute, or where your credit ends.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"seconds": {
"maximum": 7200,
"minimum": 30,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "start_session",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"max_seconds": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"room_name": {
"type": "string"
},
"room_pass": {
"type": "string"
},
"room_url": {
"type": "string"
},
"session_id": {
"type": "string"
}
},
"required": [
"session_id",
"room_url",
"room_name",
"room_pass",
"max_seconds"
],
"type": "object"
}
},
{
"description": "Asks the Nod to leave its room now, waits a few seconds for it to go, and returns the final state and cost.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "stop_session",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"charged_micro_usd": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"end_reason": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"nod_has_spoken": {
"anyOf": [
{
"type": "boolean"
},
{
"const": "unknown",
"type": "string"
}
]
},
"session_id": {
"type": "string"
},
"state": {
"enum": [
"starting",
"live",
"ended",
"failed"
],
"type": "string"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"session_id",
"state",
"end_reason",
"message",
"charged_micro_usd",
"nod_has_spoken",
"warning"
],
"type": "object"
}
},
{
"description": "Sends one message to your Nod and returns its answer, using its name, personality and brain. Works right after create_nod, before your owner verifies. Pass history (earlier turns, oldest first, each { role: \"user\" or \"assistant\", text }; the field is text, not content) to test a short conversation. Free, up to 30 turns a day in trial and 300 after. It is a text test of the brain and personality; the face and voice run when the Nod is in a room.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"history": {
"items": {
"properties": {
"role": {
"enum": [
"user",
"assistant"
],
"type": "string"
},
"text": {
"maxLength": 2000,
"type": "string"
}
},
"required": [
"role",
"text"
],
"type": "object"
},
"maxItems": 24,
"type": "array"
},
"id": {
"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)$",
"type": "string"
},
"text": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"text"
],
"type": "object"
},
"name": "test_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"reply": {
"type": "string"
},
"turns_left_today": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"reply",
"turns_left_today"
],
"type": "object"
}
},
{
"description": "Answers a Stripe TEST-mode Checkout link for one credit pack: pack-10 ($10 of credit), pack-25 ($25 of credit), pack-100 ($100 of credit). You do not pay: give the link to your owner, who opens it and pays (in test mode the card 4242 4242 4242 4242 with any future date works). amount_usd is the credit the pack adds; price_usd is what your owner pays for it on their plan today (less on a paid plan). The credit appears in get_balance a few seconds after payment. Needs a confirmed owner. Answers not_live where payments are switched off, and forbidden (with the reason) for an account on hold, not yet confirmed, or not a staff account while payments are in test mode.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"pack_id": {
"description": "One of: pack-10 ($10 of credit), pack-25 ($25 of credit), pack-100 ($100 of credit).",
"enum": [
"pack-10",
"pack-25",
"pack-100"
],
"type": "string"
}
},
"required": [
"pack_id"
],
"type": "object"
},
"name": "top_up",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"amount_usd": {
"type": "string"
},
"checkout_url": {
"description": "Give this to your owner to open and pay. It expires after 24 hours.",
"type": "string"
},
"mode": {
"const": "test",
"type": "string"
},
"next_step": {
"type": "string"
},
"pack_id": {
"type": "string"
},
"price_usd": {
"type": "string"
}
},
"required": [
"checkout_url",
"pack_id",
"amount_usd",
"price_usd",
"mode",
"next_step"
],
"type": "object"
}
},
{
"description": "Changes only the fields you pass. Set is_paused true to stop it being sent anywhere.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"abilities": {
"description": "Built-in abilities to switch on.",
"items": {
"enum": [
"catch_up",
"remember",
"look_at_screen",
"meeting_history",
"present_deck",
"magic_trick",
"sing"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
"brain": {
"description": "A brain id from list_parts, or \"default\".",
"type": "string"
},
"brain_tier": {
"description": "fast (the default) or big.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"face": {
"description": "A face id from list_parts, or \"default\".",
"type": "string"
},
"face_id": {
"description": "The avatar for the outside-anam face: your own Anam avatar id (your Anam key, added in Studio, pays), or a nodnod: id from list_faces. \"\" for none.",
"maxLength": 64,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"is_paused": {
"type": "boolean"
},
"name": {
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"personality": {
"description": "Who the Nod is and how it talks, in plain words.",
"maxLength": 4000,
"type": "string"
},
"slug": {
"description": "The last part of the page address, <web>/<handle>/<slug>. Made from the name if left out.",
"pattern": "^[a-z0-9][a-z0-9-]{0,39}$",
"type": "string"
},
"voice": {
"description": "A voice id from list_parts, or \"default\".",
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part, from list_parts or the catalogue (am_fenrir, bf_emma...). \"\" for its default.",
"pattern": "^[A-Za-z0-9_.-]{0,64}$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_nod",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"abilities": {
"description": "The built-in abilities switched on.",
"items": {
"type": "string"
},
"type": "array"
},
"audience": {
"enum": [
"private",
"invited",
"public"
],
"type": "string"
},
"brain": {
"type": "string"
},
"brain_tier": {
"description": "fast: quick answers; big: slower and deeper.",
"enum": [
"fast",
"big"
],
"type": "string"
},
"created_at": {
"type": "string"
},
"face": {
"type": "string"
},
"face_id": {
"description": "The avatar inside the face: an Anam avatar id on your own Anam account, or a nodnod: id from list_faces.",
"type": "string"
},
"id": {
"type": "string"
},
"is_paused": {
"type": "boolean"
},
"name": {
"type": "string"
},
"page_url": {
"description": "The Nod's page address; null until your owner picks an account address in NodNod Studio.",
"type": [
"string",
"null"
]
},
"personality": {
"type": "string"
},
"slug": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"voice": {
"type": "string"
},
"voice_id": {
"description": "The voice inside the voice part (a Kokoro voice such as am_fenrir); \"\" for its default.",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"personality",
"face",
"face_id",
"voice",
"voice_id",
"brain",
"brain_tier",
"abilities",
"audience",
"is_paused",
"page_url",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "If you already have a NodNod API key (from an earlier sign_up or create_key), pass it here once and the rest of this connection uses it. Not needed right after sign_up, which attaches its key for you.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "A key starting nod_sk_.",
"type": "string"
}
},
"required": [
"api_key"
],
"type": "object"
},
"name": "use_key",
"outputSchema": null
},
{
"description": "The backup to the one-click link: pass the six digit code your owner read from the NodNod email. On success the trial ends and your key can send Nods and spend. Five wrong tries closes the code; then call resend_owner_letter. Tries are also limited per key and per account (10 an hour, 20 a day). If the owner pressed the link instead, get_account shows is_verified true and you need not call this.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"code": {
"pattern": "^\\d{6}$",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "verify_owner",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"is_verified": {
"const": true,
"type": "boolean"
},
"next_step": {
"description": "What the code did, and what the link still does.",
"type": "string"
}
},
"required": [
"is_verified",
"next_step"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:907fc096cea76814c17c3d220e9a36231d12e79dcaf32b750fe47a081c166bba | sha256sum