app.trickl/trickl · v1.0.0 · docs-and-knowledge
Trickl is healthy: it completed an MCP handshake in 1541 ms and exposes 10 tools.
Trickl for AI assistants: full docs, setup plans, and sandbox tools to test purchases end to end.
Endpoint: https://api.trickl.app/mcp/dev (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 10 |
| Latency | 1541 ms |
| Last checked (UTC) | 2026-10-23T11:05:16.297Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-23T11:05:16.297Z | Healthy | 1541 |
get_started | Start here. Without an integration, explains the ways to add Trickl (own business such as a SaaS, or a multi-seller platform) and how to choose. With one, returns a step-by-step plan for the coding agent: keys, exact API calls, webhook handling, what to store, and how to prove it works with this ser |
search_docs | Keyword search over the Trickl partner docs (platform API, webhooks, embed widget). Returns section ids with snippets; read one with read_doc. Leave query empty for the full table of contents. |
read_doc | Returns one section of the Trickl docs in full (Markdown), by id from search_docs. |
check_api_key | Confirms this connector's test key works and shows its platform, scopes and mode. Run it before the other sandbox tools; if it fails, the message says what the user needs to fix. |
register_test_provider | Registers a seller (provider) under the test key via POST /providers/register and returns providerLinkCode (needed to create goals) and webhookSecret (to verify webhooks). Idempotent on externalCreatorId. webhookUrl must be a public https URL that reaches the user's receiver, e.g. an ngrok or cloudf |
create_test_goal | Creates a goal with POST /goals/create using the test key. No money moves. Returns goalId, paymentUrl (hosted checkout) and clientSecret (embedded checkout). Amounts are integer cents, USD. |
get_goal | Returns a sandbox goal's current state via GET /goals/:goalId: status, amounts saved, buyer, deadline. |
simulate_goal_event | Moves a sandbox goal through its lifecycle instantly; each event sends the real signed webhook to the seller's webhookUrl, exactly as live would. confirm: the buyer signs up and links a bank (goal.deposit_paid if there is a deposit; for subscriptions also goal.subscription_created, plus goal.cycle_p |
cancel_test_goal | Cancels a sandbox goal via POST /goals/:goalId/cancel, as the user's server would when a customer cancels: collected chunks (and a refundable deposit) are refunded in the ledger only, and goal.cancelled is sent. |
list_webhook_deliveries | Shows every webhook Trickl sent for a sandbox goal, newest first, with its payload and the receiver's result. DELIVERED = got a 2xx. FAILED = rejected, retry scheduled at nextRetryAt. EXHAUSTED = gave up. PENDING / DELIVERING = in flight; check again in a few seconds. Use lastStatusCode and lastErro |