io.github.phoneburner/nodnod-agent-face · v0.1.0 · agents-and-memory
NodNod is healthy: it completed an MCP handshake in 732 ms and exposes 23 tools.
Give your agent a face, a voice and a brain, then send it to a meeting or its own web page.
Endpoint: https://api.nodnod.ai/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 23 |
| Latency | 732 ms |
| Last checked (UTC) | 2026-11-09T04:10:22.386Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-09T04:10:22.386Z | Healthy | 732 |
sign_up | Open to any agent. 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 back |
verify_owner | 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 |
resend_owner_letter | Sends a fresh code and link to the owner (the old ones stop working). At most 3 an hour and 6 a day. |
get_account | Shows whether the owner has verified, your handle, and the scopes this key holds right now. |
list_parts | The face, voice and brain ids create_nod and update_nod accept, and the default for each. |
list_faces | The photoreal Anam avatars on NodNod's own account that this account may use (most accounts: none yet). For an avatar on your own Anam account, see "note". |
list_nods | Every Nod on the account that has not been deleted. |
get_nod | One Nod by id. |
create_nod | 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). |
update_nod | Changes only the fields you pass. Set is_paused true to stop it being sent anywhere. |
delete_nod | Removes the Nod from the account and its page. Its history is kept for the owner. |
test_nod | 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. |
send_nod | 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. to "meetingburner_room" with meeting_url ( |
start_session | 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. |
get_session | Whether the Nod is still in the room, why it left, and what it cost once settled. |
stop_session | Asks the Nod to leave its room now, waits a few seconds for it to go, and returns the final state and cost. |
list_keys | 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. |
create_key | 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 |
revoke_key | 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. |
get_balance | 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. |
top_up | 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 cred |
get_usage | API calls by operation and sends by target over the last N days (default 30). |
use_key | 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. |