X-API-KEY header (or a Bearer token). The Threads account itself is connected once
from the Magic Meal Kits app’s connection page — the credential is stored
server-side on your deployment, so callers never pass the Threads token directly
(see Authentication).
Closed beta — approved accounts only. The Threads automation is currently an
invite-only beta. Only accounts that applied and were approved can use it. Apply on
the Threads beta application page, and
the team will send account-activation instructions after review. Requests from
non-approved accounts will not be provisioned.After approval, a tester invite is sent to your Threads account. You must accept
it in the Threads app (profile → menu ☰ → Settings → Account → Website
permissions → Invites → accept Magic Meal Kits) before connecting the account —
otherwise the connection fails with
The user has not accepted the invite to test the app (error 1349245).
See the FAQ for the step-by-step walkthrough.The data endpoints require a Pro license. A Basic key is rejected with
400
and you are not a magic meal kits PRO user. The health endpoint only requires a
valid API key or Bearer token.Endpoints
All paths are under the
/api/v1 prefix (e.g. GET /api/v1/threads/user/threads).
Notes
- Connect once from the app. Link your Threads account on the connection page in the Magic Meal Kits app; the credential is stored server-side, so you call the data endpoints with just your MMK API key. If the stored token expires, reconnect there and redeploy your MCP server with the latest version.
- Page in batches. The Threads API caps a page at 100 items. When syncing to Notion, keep batches under 100 records (enable the date-range advanced option) to avoid performance issues.
- Insights are optional and slower.
include_insights=trueon/user/threadsfetches per-post metrics with bounded concurrency (max_concurrency) — expect longer response times for large accounts.
Server not responding, Google Cloud billing, or stopping/reinstalling the service?
See Troubleshooting — those topics apply to every deployment,
not just Threads.

