trickl-dev

endpoint

https://api.trickl.app/mcp/dev

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is trickl-dev live?

Yes — it answered the hub's last check (checked 9h ago). It answered 100% of checks over the last 30 days.

Is trickl-dev free to use?

Yes — the hub reached it with no key and no payment.

What tools does trickl-dev have?

10 tools: read_doc, check_api_key, get_started, register_test_provider, create_test_goal, simulate_goal_event, cancel_test_goal, get_goal, ….

Is trickl-dev safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• search_docs open 9h ago

  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.

  mcp-tool

  12345678910

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "e.g. \"deadline goal\", \"verify signature\", \"REDIRECT_URL_NOT_ALLOWED\""
      }
    },
    "additionalProperties": false
  }

  arguments 10 lines copy
• read_doc unknown never probed

  Returns one section of the Trickl docs in full (Markdown), by id from search_docs.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Section id, e.g. \"platform-api/sandbox-test-mode\""
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• check_api_key unknown never probed

  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.

  mcp-tool

  12345

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  arguments 5 lines copy
• get_started unknown never probed

  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 server's sandbox tools.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "properties": {
      "integration": {
        "enum": [
          "embed_widget",
          "own_embedded_checkout",
          "own_hosted_checkout",
          "platform_embedded_checkout",
          "platform_hosted_checkout"
        ],
        "type": "string",
        "description": "own_*: the user's own business gets paid (SaaS, app, course, membership); own_embedded_checkout puts checkout inside their app. platform_*: many sellers on the user's platform get paid. embedded = in-page iframe, hosted = redirect to Trickl. embed_widget: paste-in pricing widget, no backend. Omit to see the choices."
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• register_test_provider unknown never probed

  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 cloudflared tunnel to localhost. Sandbox webhooks are real signed HTTP requests.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "required": [
      "webhookUrl"
    ],
    "properties": {
      "email": {
        "type": "string",
        "description": "Must not belong to an existing Trickl provider. Default: a per-seller @example.com address"
      },
      "webhookUrl": {
        "type": "string",
        "description": "https URL of the user's webhook receiver"
      },
      "websiteUrl": {
        "type": "string",
        "description": "Seller site; its host is allowed for redirects and embedded checkout"
      },
      "businessName": {
        "type": "string",
        "description": "Default: Sandbox Seller"
      },
      "externalCreatorId": {
        "type": "string",
        "description": "The seller's id in the user's app. Default: sandbox-seller-1"
      },
      "stripeConnectAccountId": {
        "type": "string",
        "description": "Leave empty in sandbox: a placeholder is used, since sandbox goals never reach Stripe"
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• create_test_goal unknown never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667

  {
    "type": "object",
    "required": [
      "providerLinkCode",
      "targetAmount",
      "description"
    ],
    "properties": {
      "deadline": {
        "type": "string",
        "description": "ISO 8601 due date, 24h to 2 years out (one-time goals only)"
      },
      "imageUrl": {
        "type": "string"
      },
      "metadata": {
        "type": "object",
        "description": "Echoed verbatim in every webhook, e.g. { orderId }",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      },
      "cancelUrl": {
        "type": "string"
      },
      "frequency": {
        "enum": [
          "WEEKLY",
          "BIWEEKLY",
          "MONTHLY",
          "QUARTERLY",
          "YEARLY"
        ],
        "type": "string",
        "description": "Makes it a recurring subscription; omit for a one-time purchase"
      },
      "callbackUrl": {
        "type": "string",
        "description": "Where the buyer returns after confirming; localhost is allowed in test mode"
      },
      "description": {
        "type": "string",
        "description": "What the buyer is saving for, max 500 characters"
      },
      "targetAmount": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": 50,
        "description": "Price in cents, e.g. 2999 = $29.99"
      },
      "depositAmount": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "description": "Upfront card charge in cents. One-time: ≥ 50 and < targetAmount. Subscription: = targetAmount or omit"
      },
      "providerLinkCode": {
        "type": "string",
        "description": "From register_test_provider"
      },
      "depositRefundable": {
        "type": "boolean"
      }
    },
    "additionalProperties": false
  }

  arguments 67 lines copy
• simulate_goal_event unknown never probed

  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_paid at once if the deposit paid the first period in full). collect: one round-up chunk, $3 by default (goal.round_up_collected); fails with ALREADY_FUNDED when the current period is already paid. complete: one-time goals finish (goal.completed); subscriptions pay the current period and start the next (goal.cycle_paid; the goal stays SAVING). payment_failed: a failed chunk (goal.payment_failed), with reversal=true for the clawback path. expire: a deadline goal fell short (goal.deadline_charge_failed). Confirm first.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "required": [
      "goalId",
      "event"
    ],
    "properties": {
      "event": {
        "enum": [
          "confirm",
          "collect",
          "complete",
          "payment_failed",
          "expire"
        ],
        "type": "string"
      },
      "amount": {
        "type": "integer",
        "maximum": 9007199254740991,
        "description": "collect / payment_failed only: cents, default 300",
        "exclusiveMinimum": 0
      },
      "goalId": {
        "type": "string",
        "description": "goalId from create_test_goal"
      },
      "reason": {
        "enum": [
          "ach_return",
          "dispute"
        ],
        "type": "string",
        "description": "payment_failed with reversal only"
      },
      "reversal": {
        "type": "boolean",
        "description": "payment_failed only: true = a chunk already counted is reversed (clawback); false = a collection failed"
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• cancel_test_goal unknown never probed

  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.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "goalId"
    ],
    "properties": {
      "goalId": {
        "type": "string",
        "description": "goalId from create_test_goal"
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_goal unknown 9h ago

  Returns a sandbox goal's current state via GET /goals/:goalId: status, amounts saved, buyer, deadline.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "goalId"
    ],
    "properties": {
      "goalId": {
        "type": "string",
        "description": "goalId from create_test_goal"
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• list_webhook_deliveries unknown 9h ago

  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 lastError to debug the receiver.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "goalId"
    ],
    "properties": {
      "goalId": {
        "type": "string",
        "description": "goalId from create_test_goal"
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.