# MCP server

> Connect an AI client with OAuth.

Source: https://www.onlucra.com/docs/mcp

Lucra's MCP server gives an AI client a tool for every API endpoint, with the same access and checks as REST. Add it to your client and sign in; there's no key to copy.

## Connect

Add a custom MCP server in your client with these settings, then sign in when it asks:

| Field          | Value                             |
| -------------- | --------------------------------- |
| URL            | `https://api.onlucra.com/api/mcp` |
| Transport      | Streamable HTTP                   |
| Authentication | OAuth                             |

When you sign in, you pick the account and grant `read`, or `read` and `write`. API keys don't work here. Disconnect anytime in **Settings → Connected apps**.

## Tools

Tools are named after SDK methods in snake case: `programs_list`, `submissions_update`, `payments_create`. Each takes:

- path IDs, like `id`,
- `query` and `body`, as in the API,
- `account`, to act for another account (like the `Lucra-Account` header),
- `idempotencyKey`, on writes.

A `read` grant sees only read tools. File upload has no tool; upload over [REST](https://www.onlucra.com/docs/api-files).

## Troubleshooting

| Result                  | Check                                            |
| ----------------------- | ------------------------------------------------ |
| `401`                   | Sign in again; API keys are refused              |
| A write tool is missing | Reconnect and grant `write`                      |
| `account_not_reachable` | `account` must be one your sign-in can reach     |