mpt-curl

Python replacement for ~/bin/mpt-curl built on mpt-api-python-client.

For GET requests to collection endpoints, pages are fetched automatically and streamed to stdout as a single JSON object ({"data":[...], "$meta":{...}}).

The first request is sent as-is. Auto-paging starts only if the response has $meta.pagination; further pages use limit=1000 by default. With total in pagination, paging follows it; otherwise it continues while each page is full. Disabled when the URL contains limit= or offset=.

Install

pip install mpt-curl

Configuration

Uses the active account from mpt-cli accounts (~/.swocli/accounts.json, is_active: true), same as the shell wrapper.

Override with environment variables:

• MPT_API_BASE_URL
• MPT_API_TOKEN

Usage

# List agreements (auto-paged)
mpt-curl /commerce/agreements

# Same with /public/v1 or /v1 prefix — resolved like the shell script
mpt-curl /public/v1/commerce/agreements
mpt-curl /v1/commerce/agreements
mpt-curl /commerce/agreements

# Filter with RQL
mpt-curl '/commerce/agreements?and(eq(status,Active))'

# Single page (limit= or offset= in URL disables auto-paging)
mpt-curl '/commerce/agreements?limit=10'

# POST (-d alone implies POST, like curl)
mpt-curl /commerce/orders -d '{"type":"Change","agreement":{"id":"AGR-123"}}'
mpt-curl -X POST /commerce/orders -d '{"type":"Change","agreement":{"id":"AGR-123"}}'

# PUT with body
mpt-curl -X PUT /commerce/orders/ORD-123 -d '{"status":"Processing"}'

Options

Automatic paging is also disabled when the URL already contains limit= or offset=.

Development

From a checkout:

uv sync --group dev
uv run pytest