> ## Documentation Index
> Fetch the complete documentation index at: https://docs.straddle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read an account through API MCP

> Discover a current operation and inspect one sandbox account with your coding agent.

Use API MCP to read an existing sandbox account and verify that your configured key can reach it. The workflow discovers the operation, reviews the request, and inspects the result.

## Before you start

Prepare the following:

* [Connect API MCP](/developer-tools/mcp/install) with a sandbox API key.
* Choose an existing sandbox account ID that your key can read.
* Confirm the request host is `https://sandbox.straddle.com`.

The account ID goes in the request path. Account-management requests omit `Straddle-Account-Id` for every integration model.

## Discover and run the read

<Steps>
  <Step title="Find the operation">
    Ask the agent to discover the account read and show you its inputs:

    <Prompt description="Find the sandbox account read." actions={["copy"]}>
      Use straddle-api's search-openapi-operations to find the operation that gets one account by ID. Read its current schema and capture the Scalar document-version and operation IDs from this result. Ask me for the sandbox account ID, then show the proposed GET request to [https://sandbox.straddle.com](https://sandbox.straddle.com) with Straddle-Account-Id omitted. Wait for me to confirm the read.
    </Prompt>

    Discovery returns the operation's schema for your review before execution.
  </Step>

  <Step title="Review the request">
    Check the proposed values:

    | Input | Expected value |
    | - | - |
    | `method` | `GET` |
    | `serverBaseUrl` | `https://sandbox.straddle.com` |
    | `path` | `/v1/accounts/` followed by your chosen account ID |
    | `xScalarDocumentId` | The discovered `x-scalar-document-version-id`. |
    | `xScalarOperationId` | The discovered operation's `x-scalar-operation-id`. |
    | Account header | Omitted. |

    Your client supplies the bearer token. Keep the key out of the prompt and tool arguments.
  </Step>

  <Step title="Run the read">
    Confirm the proposed request and let the agent call `execute-request` once. Review the client's tool approval prompt if it appears.

    Ask the agent to report the HTTP status, returned account ID, account status, and request ID when available. Keep personal and business details out of the summary unless your task needs them.
  </Step>

  <Step title="Inspect the result">
    A successful response verifies access to that sandbox account with the configured key. Confirm the returned account ID matches the one you selected.

    For a failed response, keep the status and request ID and follow [MCP troubleshooting](/developer-tools/mcp/troubleshooting).
  </Step>
</Steps>

## Use current Scalar IDs

Take both IDs from `search-openapi-operations` in the same session. Contract publication can change them.

The OpenAPI `operationId`, such as `getAccount`, is a human-readable name. `execute-request` needs the Scalar UUID from `x-scalar-operation-id`.

## Adapt the workflow

For another read, discover that operation's schema and review its parameters first. Put query parameters in `path`, for example `/v1/accounts?page_size=1`. Apply the [account-scope rules](/developer-tools/mcp/account-scoping) for the resource and integration model.

For implementation and sandbox writes, use the [Straddle skills](/developer-tools/skills/use-kit). They prepare request previews and choose the SDK, CLI, or API MCP route for each operation. [Authentication and permissions](/developer-tools/mcp/safety) explains those choices.


## Related topics

- [Set account scope](/developer-tools/mcp/account-scoping.md)
- [Authentication and permissions](/developer-tools/mcp/safety.md)
- [Connect your agent to Straddle](/developer-tools/mcp/overview.md)
- [Connect MCP](/developer-tools/mcp/install.md)
- [Troubleshoot MCP](/developer-tools/mcp/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.