# Connect an assistant

*nods · The platform*

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](https://nods.to/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.

---
https://docs.nods.to/mcp/ · nods 0.1.0 · MIT