# get-connection

The get-connection MCP tool: see which CloudFiles account a connection reaches and which user it acts as.

> Kind: Guide · Updated: Nov 4, 2026

Shows the CloudFiles account a connection reaches and the user it acts as. An agent can call it to check which account it is working in, for example before generating documents, and a person with more than one connection, for example to a production and a sandbox account, can use it to check which one an app is using.

## Before you use this tool

Every connection includes get-connection, whether it uses an MCP credential or an AI app sign-in, and it needs no CloudFiles license. It only reads information and changes nothing.

## Inputs

get-connection takes no inputs.

## Outputs

| Field | Description |
|---|---|
| accountId | The ID of the CloudFiles account the connection reaches. |
| accountName | The name of that CloudFiles account, when it has one. |
| runAsUser | The user the connection acts as, with its id and email. For an MCP credential, this is your CloudFiles account's system user. For an AI app sign-in, it is the person who signed in. See Who the Agent Acts As. |

## Example requests

| You ask | What the agent does |
|---|---|
| Which CloudFiles account are you connected to? | Calls get-connection and answers with the account name and the user it acts as. |
| Am I connected to our sandbox or production account? | Calls get-connection and reports the account name, so you can tell which account the app reaches. |