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

# Limits and credits

> Understand MCP data limits, cost approvals, and which tools can change data.

## Data and wait limits

| Operation | Limit or behavior |
| - | - |
| `upload_dataset` | Small CSV or JSONL text, bounded to 5 MiB; larger files should use the Landbase UI or CLI |
| `preview_dataset` | Up to 100 rows; long cell values are trimmed to 500 characters plus an ellipsis |
| `list_datasets` | Up to 100 datasets per call, with `offset` for pagination |
| Search and run polling | `wait_seconds` ranges from 0 to 40; reaching that limit does not cancel remote work |
| Download links | Temporary links, with an expiry of about 30 minutes |

A preview is a sample, not a full export. Use `get_dataset_fields` for
field names and the publish/download tools for a complete file.

## Workflow and download approval

Paid workflow types include enrichment, qualification, research, contact
enrichment, and similar-company expansion. Call without `confirm` first.
When the result is `needs_confirmation`, show the quote or row count and
ask for agreement before repeating with `confirm: true`. Keep the selected
`account_id` on both calls, and on every subsequent workflow poll and download.

An exact estimate is not always available. A missing estimate does not mean
an operation is free. `get_download_url` also requires approval and reports
the row count before the confirmed call.

Limit rows with `transform_dataset` before requesting a quote if you want to
process a smaller set. Use the transform's `output_dataset_id` for the paid
call so the quote and operation apply to the same working set.

## Research search approval

`search` in `research` mode uses a separate conversation flow. The initial
turn can finish with a SQL proposal and credit quote but no dataset. Show that
proposal and wait for user agreement. After approval, call:

```json theme={null}
{
  "query": "confirm",
  "mode": "research",
  "session_id": "00000000-0000-4000-8000-000000000001",
  "account_id": "447"
}
```

Replace the example IDs with the original research session ID and selected
account. `search` has no `confirm` boolean argument. Keep the same session
and account so approval applies to the quoted research request.

Continue polling any returned handle or workflow ID; a completed quote turn
does not mean the research dataset has been built.

## Changes and permissions

Preview and metadata tools inspect data. Other tools can upload, create,
publish, delete, or process datasets. `delete_dataset` requires explicit
confirmation. Cancel a workflow only when the user asks to stop it; cancellation
does not undo completed work or credits already spent.

An approval argument is a client instruction, not an independent guarantee
that a person approved the action. Keep your client's tool-approval controls
enabled and review changes and costs. Passing an `account_id` selects request
context; it does not grant access to that account.

For prompts that apply these approval rules, see the [MCP prompt cookbook](https://www.landbase.com/docs/guides/mcp/prompt-cookbook.md). For client-specific recovery, see [Connect Landbase to Grok Bot](https://www.landbase.com/docs/guides/mcp/grok-bot.md) and [Troubleshoot MCP](https://www.landbase.com/docs/guides/mcp/troubleshooting.md).


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