Using the AI Assistant

Radial includes a built-in AI Assistant that can answer questions about your workspace, grounded in your real project data, so you can ask in plain language instead of hunting through screens.

What you can ask

The Assistant understands your projects, items, team, and career data. For example:

• “Which projects have open RedButton risks right now?”
• “What items is Priya assigned that aren’t complete yet?”
• “Which of my completed items are missing notes?”

Open it from the Assistant area in the app and type your question. Answers stream back as they’re generated.

Grounded in your data

The Assistant reads from your workspace, so its answers reflect your actual projects rather than generic knowledge. It respects your access: it can only see what you’re allowed to see.

Monthly usage

Each plan includes a monthly allowance of AI Assistant interactions, with a higher allowance on Pro. If you reach your limit, you’ll be prompted to upgrade or wait until the allowance resets. See Plans & Pricing for current allowances.

Connect your own tools (MCP)

Radial runs a Model Context Protocol (MCP) server, so you can use your Radial workspace from your own AI assistant, such as Claude, instead of the built-in one. MCP is available on every plan, and it doesn’t use your monthly Assistant allowance.

Point any MCP client that supports remote servers at:

https://mcp.radialapp.com/mcp

For example, in Claude add it as a custom connector, or in Claude Code run:

claude mcp add --transport http radial https://mcp.radialapp.com/mcp

The first time you connect, a browser window opens so you can sign in with your Radial account. There is no key to copy. If you belong to more than one workspace you choose one then, and you can ask your assistant to switch workspace at any time.

MCP works as you: it sees exactly what you can see in Radial. It can read your projects, items, members and career data, and search your notes. The one thing it can change is a project’s chat: it can post a message there, as you. It can’t edit items or notes, or complete or verify anything.

To pull data into a script or another system with no one signed in, use the export API below.

Pull your data with the export API

The export API lets your own systems pull your workspace’s data out of Radial over plain HTTP: a script, a scheduled spreadsheet refresh, or a CAD tool such as Grasshopper. It needs no one to be signed in. It is read-only and available on every plan.

Get a token

A workspace admin opens Settings → API access and selects Generate token. The token is shown once. Copy it and store it somewhere safe: Radial keeps no copy and cannot show it again.

• Regenerate token issues a new token. The old one stops working on its next request.
• Revoke access turns the API off for the workspace. Turning it back on issues a new token; an old one never works again.

The token reads your whole workspace, so treat it like a password.

Send a request

Send the token in an Authorization header. Never put it in a web address: addresses are kept in server logs and browser history, and Radial rejects a token sent that way.

curl -H "Authorization: Bearer radial_export_YOUR_TOKEN" \
  "https://radialapp.com/api/export/v1/items"

Settings → API access → How to use it has this command with your workspace’s address filled in, and a ready-to-paste Grasshopper (GhPython) script.

Endpoints

Endpoint	Returns
GET /api/export/v1/items	Every item on every project’s WorkMAP™.
GET /api/export/v1/projects	Every project, with its site address and its Australian Standard load classifications.

Items. Each item carries its title, its Area, its project (number, name and status), the names of its owner, completer and verifier, when it was completed and verified, its priority, its confidence, and a status of not_started, in_progress, complete or verified. It never carries notes, Q&A, RedButton content or anyone’s email address. Add ?project=<number> to return one project’s items, where the number is the one in the project’s web address.

Projects. Each project carries its number, name, status, site address and map coordinates, and five load classifications: wind, importance level, snow, seismic and durability. These are read from the project’s classification items, from lines written as Label = value. Only those lines leave Radial; the rest of the notes never do. Where a line can’t be reduced to a single clean value, the value is left empty and the line itself is returned, so nothing is guessed.

Paging

Results come a page at a time: 100 by default, up to 500 with ?limit=. Each response ends with a nextCursor. Pass it back as ?cursor= to get the next page, and stop when it is null.

Errors

Errors come back as JSON with a code and a plain message.

Status	Code	Meaning
401	unauthorized	The token is missing, wrong, regenerated or revoked.
400	invalid_request	limit, cursor or project isn’t a valid number.
404	project_not_found	No project has the number you passed in project.
500	internal_error	Something went wrong on our side. Try again.