{"openapi":"3.1.0","info":{"title":"Stripe Radar (BYOK) API","version":"0.1.0","description":"Stripe Radar (BYOK) lets an AI assistant read your own Stripe Radar data through the Stripe Radar API with a key you supply (restricted API key with read permissions only (starts with rk_live_ or rk_test_)). Read-only: 6 tools (list_value_lists, get_value_list, list_early_fraud_warnings, get_early_fraud_warning, list_reviews, get_review). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-stripe-radar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-stripe-radar/docs"},"termsOfService":"https://connectorbay.com/byok-stripe-radar/terms"},"servers":[{"url":"https://byok-stripe-radar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-stripe-radar/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_value_lists":{"post":{"operationId":"list_value_lists","summary":"List your Radar value lists (allow lists, block lists and custom lists) with name, alias and the type of value each hold","description":"List your Radar value lists (allow lists, block lists and custom lists) with name, alias and the type of value each holds. List contents are not returned. Works with a restricted key that has read access to this resource only. Use for \"Which Radar value lists do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"alias":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the list with this alias, for example 'custom_blocklist'.","title":"Alias"},"contains":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only lists that contain this value.","title":"Contains"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many objects to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page: the id of the last object on the previous page. Use it while has_more is true.","title":"Starting After"}},"title":"list_value_listsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_value_list":{"post":{"operationId":"get_value_list","summary":"Get one Radar value list by id: name, alias, item type, creator and creation time. The items are not returned. Works wit","description":"Get one Radar value list by id: name, alias, item type, creator and creation time. The items are not returned. Works with a restricted key that has read access to this resource only. Use for \"What kind of values does Radar list rsl_1Nf3pq hold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value_list":{"description":"Value list id, for example rsl_1Nf3pqLkdIwHu7ixAbCdEfGh.","maxLength":200,"title":"Value List","type":"string"}},"required":["value_list"],"title":"get_value_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_early_fraud_warnings":{"post":{"operationId":"list_early_fraud_warnings","summary":"List early fraud warnings issued by card networks for your charges, with the fraud type, whether action is still possibl","description":"List early fraud warnings issued by card networks for your charges, with the fraud type, whether action is still possible, and the charge and payment intent ids. Works with a restricted key that has read access to this resource only. Use for \"Do I have any early fraud warnings to act on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"charge":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only warnings for this charge id, for example ch_3Nf3pq.","title":"Charge"},"payment_intent":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only warnings for this payment intent id.","title":"Payment Intent"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many objects to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page: the id of the last object on the previous page. Use it while has_more is true.","title":"Starting After"}},"title":"list_early_fraud_warningsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_early_fraud_warning":{"post":{"operationId":"get_early_fraud_warning","summary":"Get one early fraud warning by id with fraud type, whether it is actionable, and the related charge and payment intent. ","description":"Get one early fraud warning by id with fraud type, whether it is actionable, and the related charge and payment intent. Works with a restricted key that has read access to this resource only. Use for \"What is early fraud warning issfr_1Nf3pq about\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"early_fraud_warning":{"description":"Early fraud warning id, for example issfr_1Nf3pqLkdIwHu7ixAbCdEfGh.","maxLength":200,"title":"Early Fraud Warning","type":"string"}},"required":["early_fraud_warning"],"title":"get_early_fraud_warningArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_reviews":{"post":{"operationId":"list_reviews","summary":"List Radar reviews that are currently open, with the reason each was opened (rule or manual) and the charge and payment ","description":"List Radar reviews that are currently open, with the reason each was opened (rule or manual) and the charge and payment intent ids. IP address and ZIP code are not returned. Works with a restricted key that has read access to this resource only. Use for \"Which payments are waiting in my Radar review queue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many objects to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page: the id of the last object on the previous page. Use it while has_more is true.","title":"Starting After"}},"title":"list_reviewsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_review":{"post":{"operationId":"get_review","summary":"Get one Radar review by id: open state, why it was opened and closed, and the related charge and payment intent. Works w","description":"Get one Radar review by id: open state, why it was opened and closed, and the related charge and payment intent. Works with a restricted key that has read access to this resource only. Use for \"Why was review prv_1Nf3pq opened\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"review":{"description":"Review id, for example prv_1Nf3pqLkdIwHu7ixAbCdEfGh.","maxLength":200,"title":"Review","type":"string"}},"required":["review"],"title":"get_reviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}