Aroai
Start building free

Quickstart

Run your first useful Aroai task

Create a workspace, connect over Streamable HTTP and search a New Zealand business using a compatible MCP client.

Start building freeRead the quickstart

You will need

  • An Aroai workspace. Researcher includes 1,000 credits each billing month.
  • A client that supports remote MCP over Streamable HTTP.
  • OAuth or an Aroai API key supported by that client.

Create or open a workspace

Start at app.aroai.com/signup, or sign in to an existing workspace. Workspace membership controls which tools are available.

Connect to the server

Use the combined MCP endpoint. Claude Code's command is shown here; follow the matching guide for other clients.

Claude Code · Streamable HTTP
claude mcp add --transport http aroai https://mcp.aroai.com/v1

Authenticate safely

For OAuth, follow the sign-in flow your client discovers. For an API key, create one under API keys in the portal and keep it in protected client credentials.

API-key header · do not commit a real secret
Authorization: Bearer aroai_live_YOUR_SECRET_KEY

Discover and run the task

  1. 01

    List tools

    Ask your client to discover Aroai tools. The list reflects workspace access and client support.

  2. 02

    Search

    Call nzbn_search with a business name you want to research. Its required query is at least two characters.

  3. 03

    Review candidates

    Check candidate names and identifiers and resolve ambiguous matches.

  4. 04

    Open a record

    Use an actual returned 13-digit NZBN in nzbn_get_entity, following the discovered schema.

  5. 05

    Check the result

    Keep returned fields and missing information visible. A connected indicator alone does not complete the task.

Example request

nzbn_search · syntax example, current record not guaranteed
{
  "query": "AroAI Limited",
  "limit": 10,
  "detail": "standard"
}

If it does not work

Check the endpoint and authentication first. Then confirm workspace access, tool enablement, client feature support and remaining credits. A no-match result is valid; do not invent a business record.

Keep building

A useful next step

Local intelligence. Ready to build.

Start with a task you can inspect.

Connect a compatible client, choose a workflow and review the source fields that come back.

Start building freeExplore tools