MCP
Image, PDF & file tools MCP
Use Streamable HTTP so AI clients can discover and call the same shared tool contract.
Endpoint: https://attachready.com/mcp
Every request requires a Better Auth session cookie or an API-key Bearer token. The server returns a requestId and rejects invalid or expired credentials.
MCP uploads use name, mimeType, and contentBase64 with upload_file; pass the returned file id to conversion tools.
Create / manage API keys: create a key after registering and verifying your email. The full secret is shown once. MCP shares the account quota with web and REST.
BASE_URL="https://attachready.com"
# Set API_KEY to your private account API key.
INIT=$(curl -si -N "$BASE_URL/mcp" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}')
SESSION_ID=$(printf '%s' "$INIT" | awk 'tolower($0) ~ /mcp-session-id:/ {print $2}' | tr -d '\r')
curl -N "$BASE_URL/mcp" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: $SESSION_ID" \
--data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'inspect_file
public · sync · 70s
Inspect uploaded bytes by fileId, or normalize supplied file facts.
upload_file
user · sync · 70s
Store an authenticated input file for later tool jobs.
validate_file
public · sync · 70s
Compare file facts with explicit submission rules.
compress_image
user · async · 70s
Compress to a 200,000-byte target in JPEG, PNG, WebP or AVIF and verify real output size before downloading.
inspect_image
user · async · 70s
Inspect decoded image dimensions, format, DPI, frames and EXIF/GPS presence before converting. Basic browser checks are also available locally.
convert_image
user · async · 70s
Convert HEIC, HEIF, JPEG, PNG, WebP, AVIF, GIF or TIFF into JPEG, PNG, WebP or AVIF. Check output size and transparency before submitting.
resize_image
user · async · 70s
Resize images by pixel dimensions with contain or cover fit. Set print DPI separately and verify the decoded output before uploading a form.
crop_image
user · async · 70s
Crop images using x, y, width and height in pixels. Correct EXIF orientation first, then export a checked image in your chosen format.
remove_background
user · async · 70s
Remove the background from an image and download a transparent PNG.
compress_pdf
user · async · 70s
Run a bounded PDF optimization job, inspect the actual output bytes, and receive a rule failure when the limit cannot be met.
convert_image_to_pdf
user · async · 70s
Turn JPEG, PNG, WebP, AVIF, HEIC, GIF or TIFF images into a checked PDF with ordered pages and original, A4 or Letter layout.
merge_pdfs
user · async · 70s
Combine several readable PDFs into one artifact, preserve input order, and verify the resulting page facts.
split_pdf
user · async · 70s
Create a new PDF from selected pages, ranges or repeated pages. Use page expressions such as 1-3,5 to prepare only the material a form requires.
rotate_pdf
user · async · 70s
Rotate PDF pages by 90, 180 or 270 degrees clockwise. Apply rotation to the full document or a specific range and inspect the resulting file.
create_submission_package
user · async · 70s
Create a ZIP of original materials plus a manifest and JSON/Markdown preflight reports. Use a free account for standard names or Pro for custom naming.
get_job
user · sync · 70s
Read the status of your asynchronous job.
list_jobs
user · sync · 70s
List your asynchronous jobs with cursor pagination.
cancel_job
user · sync · 70s
Cancel one of your unfinished asynchronous jobs.
download_artifact
user · sync · 70s
Create a short-lived download for your output file.
save_rule
user · sync · 70s
Save a reusable submission rule template in your account.
list_rules
user · sync · 70s
List the submission rule templates in your account.
get_rule
user · sync · 70s
Read one of your saved submission rule templates.
delete_rule
user · sync · 70s
Delete one of your saved submission rule templates.
get_entitlements
user · sync · 70s
Read your daily usage, quota and tool limits.