Connect an assistant
An API token lets an assistant read and change your page and your credit over the Model Context Protocol.
Make a token in the app.
The owner of a studio makes one under Settings, then API. The token is shown once, and nods keeps only its hash. A studio holds twenty at most, and revoking one stops it at the next request.
Add the server to your assistant.
The server speaks the Model Context Protocol over HTTP at https://nods.to/api/mcp. Send the token as a bearer token. The token names the studio, so every tool acts in that studio and no other.
Terminal
claude mcp add --transport http nods https://nods.to/api/mcp --header "Authorization: Bearer <token>"
It answers revisions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26 of the protocol. Each request is one JSON-RPC message and each answer is one JSON object.
Call any of the twelve tools.
A starred argument is required.
| Tool | What it does | Takes |
|---|---|---|
get_page | Read the page | Nothing |
list_widget_kinds | List the kinds of widget | Nothing |
add_widget | Add a widget | kind*, data |
update_widget | Change a widget | id*, data* |
move_widget | Move a widget | id*, direction, position |
set_widget_hidden | Hide or show a widget | id*, hidden* |
remove_widget | Delete a widget | id* |
set_profile | Change the profile | tagline, place |
set_style | Change the style | preset, layout, align, ground, ink, accent, face, corner, mark |
set_css | Change the stylesheet | css* |
get_credit | Read the credit | Nothing |
set_credit | Change the credit | card, line, ground, ink, accent, lineColour, palette |
tools/list returns the full schema of each, with every value an argument accepts.
Read a refusal as a result.
A change that is refused comes back as a tool result with isError: true and a sentence saying why, so the assistant that asked can put it right. A tool saves all of a change or none of it. Pricing lists what each plan includes.
A request with no token, or with one that is unknown or revoked, is answered 401. A token may make 120 requests a minute. One past that is answered 429, with the seconds to wait in Retry-After.
Upload pictures in the app.
A tool reaches the widgets of your page and the look of your credit. It can reorder, describe or drop the pictures a gallery has. Adding a picture, and editing a project story, are done in the app.