Documentation

Tools exposed by Big CSV Tools and the limits that apply.

Connect

Server URL: https://bigcsv.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

`start_csv_job`

Starts one operation on a CSV or TSV file given as a public URL: dedupe, diff, merge, split or profile. Counts one job.

Inputs: operation, file_url, and depending on the operation: second_file_url, key_columns, keep, join, split_by, rows_per_file, split_column, ignore_case, delimiter
Limits: Jobs per month and rows per file depend on the plan. CSV and TSV only; XLSX: save as CSV first.

Remove duplicate rows from https://example.com/contacts.csv by the email column and keep the first row.

`get_csv_job`

Progress for a job; advances it by one batch. When finished it returns a short summary and download links.

Inputs: job_id
Limits: One batch per call. Download links expire after 7 days.

How is CSV job abc going?

`list_csv_jobs`

Lists the latest 20 CSV jobs for the account with operation, status, progress and number of output files.

Inputs: none
Limits: Latest 20.

List my CSV jobs.

`account_status`

Shows the account email, plan, usage and limits.

Inputs: none
Limits: none

Show my account status.

`activate_license`

Binds a licence key to the account.

Inputs: license_key (string)
Limits: Key must belong to this product.

Activate licence key XXXX-XXXX.

Plan limits

Limit	Free	Pro
jobs	3	100
rows per file	10000	1000000

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://bigcsv.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.