Humans get a web upload. Automation gets the same pipeline.
REST API
Create a job with a base64 JSON image or multipart upload, poll the job endpoint, and download the ZIP after its status becomes ready. API requests use bearer keys created in the signed-in app and require an active or trial entitlement.
Plaintext keys are shown once when created. Text2Folders stores only the key hash and visible prefix.
MCP tool
The MCP server provides create_job, get_job, and list_jobs. It accepts the same Text2Folders bearer keys and forwards requests to the REST API, where account ownership and entitlement checks remain enforced. Hosted MCP OAuth is not implemented in staging.
When to use which
| Use case | Prefer |
|---|---|
| Occasional packs | Web app |
| Recurring batch jobs | REST API |
| Agent workflows in the IDE | MCP |
See the developer guide for current endpoints and MCP client configuration. Text2Folders remains internal staging, so interfaces and availability may change.
