> For the complete documentation index, see [llms.txt](https://timechain.gitbook.io/neucron-mcp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://timechain.gitbook.io/neucron-mcp/tools/auth-setup.md).

# auth setup

Tools for authenticating with Neucron, selecting your operating entity, and registering new businesses.

These tools are typically used at the start of a session before calling business-scoped tools.

***

## `neucron_login`

**Authenticate a user via email and password and receive a session token.**

Use this tool when you have not set `NEUCRON_AUTH_TOKEN` in your MCP client environment. On success, the server stores the token in-process for all subsequent tool calls in the same session.

| Parameter              | Type      | Description                   |
| ---------------------- | --------- | ----------------------------- |
| `method`               | `"email"` | Login method (email only)     |
| `credentials.email`    | string    | Your Neucron account email    |
| `credentials.password` | string    | Your Neucron account password |

**Example**

```json
{
  "method": "email",
  "credentials": {
    "email": "user@example.com",
    "password": "your-password"
  }
}
```

**Returns:** Session token and authentication status.

***

## `neucron_choose_entity`

**List available personal and business entities and set the active operating context.**

After logging in, use this tool to discover which businesses and personal accounts you have access to, and to confirm which `businessId` will be used for subsequent operations.

| Parameter             | Type    | Description                                           |
| --------------------- | ------- | ----------------------------------------------------- |
| `businessId`          | string  | The business ID to set as active context              |
| `loadBusinessDetails` | boolean | Whether to load full business details after selection |

**Example**

```json
{
  "businessId": "<business-id>",
  "loadBusinessDetails": true
}
```

**Returns:** Entity list and active business context.

***

## `neucron_create_business`

**Register a new business entity with KYB (Know Your Business) details.**

Creates a new business on the Neucron platform and returns the new `business_id`. Use this when onboarding a new organization before performing business-scoped operations.

| Parameter           | Type    | Description                                         |
| ------------------- | ------- | --------------------------------------------------- |
| `businessId`        | string  | Business ID used for post-creation update steps     |
| `payload`           | object  | KYB registration payload                            |
| `submitKyb`         | boolean | Whether to submit KYB for review                    |
| `updateAfterCreate` | object  | Additional business details to apply after creation |

**Returns:** New business ID and registration status.

***

## Typical session flow

```
1. neucron_login          → authenticate
2. neucron_choose_entity  → select business context
3. neucron_list_wallets   → (or any other business tool)
```

If `NEUCRON_AUTH_TOKEN` and `NEUCRON_BUSINESS_ID` are already set in your environment, you can skip steps 1 and 2 and go directly to business tools.