{"openapi":"3.1.0","info":{"title":"Rapid7 Insight Platform Account (BYOK) API","version":"0.1.0","description":"Rapid7 Insight Platform Account (BYOK) lets an AI assistant read your own Rapid7 Insight Platform Account data through the Rapid7 Insight Platform Account API with a key you supply (Rapid7 Insight platform API key (user or organization key)). Read-only: 8 tools (get_organization, list_products, list_roles, get_role, list_user_groups, list_features, list_resource_sets, list_managed_organizations)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-rapid7-insight-platform.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-rapid7-insight-platform/docs"},"termsOfService":"https://connectorbay.com/byok-rapid7-insight-platform/terms"},"servers":[{"url":"https://byok-rapid7-insight-platform.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-rapid7-insight-platform/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/get_organization":{"post":{"operationId":"get_organization","summary":"Show the Rapid7 organization the key belongs to: id, name, external id and region. Use for \"Which Rapid7 organization is","description":"Show the Rapid7 organization the key belongs to: id, name, external id and region. Use for \"Which Rapid7 organization is my API key for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"get_organizationArguments","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_products":{"post":{"operationId":"list_products","summary":"List the Rapid7 products licensed to the organization with product code, product token and, when asked, their features. ","description":"List the Rapid7 products licensed to the organization with product code, product token and, when asked, their features. Use for \"Which Rapid7 products does my organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"include_associated_features":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include the features of products that support role-based access.","title":"Include Associated Features"}},"required":["region"],"title":"list_productsArguments","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_roles":{"post":{"operationId":"list_roles","summary":"List the roles defined for the organization with their supported products. Optionally filter by product code. Use for \"W","description":"List the roles defined for the organization with their supported products. Optionally filter by product code. Use for \"What roles exist in my Rapid7 organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"product_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only roles supporting this product code, for example IDR or IVM.","title":"Product Code"},"include_role_feature_permissions":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include the feature permissions of each role.","title":"Include Role Feature Permissions"}},"required":["region"],"title":"list_rolesArguments","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_role":{"post":{"operationId":"get_role","summary":"Get one role: name, description, organization and supported products. Use for \"What does the Rapid7 role 88a7b240 allow\"","description":"Get one role: name, description, organization and supported products. Use for \"What does the Rapid7 role 88a7b240 allow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"role_id":{"description":"Role id (from list_roles).","maxLength":200,"title":"Role Id","type":"string"}},"required":["region","role_id"],"title":"get_roleArguments","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_user_groups":{"post":{"operationId":"list_user_groups","summary":"List the user groups of the organization with name and description (members are not returned). Use for \"Which user group","description":"List the user groups of the organization with name and description (members are not returned). Use for \"Which user groups exist in my Rapid7 organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_user_groupsArguments","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_features":{"post":{"operationId":"list_features","summary":"List the platform features and the permissions each can grant. Use for \"Which Rapid7 features and permissions can be ass","description":"List the platform features and the permissions each can grant. Use for \"Which Rapid7 features and permissions can be assigned in roles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_featuresArguments","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_resource_sets":{"post":{"operationId":"list_resource_sets","summary":"List resource sets (named collections of resources used to scope access) with their resource group. Use for \"Which Rapid","description":"List resource sets (named collections of resources used to scope access) with their resource group. Use for \"Which Rapid7 resource sets are defined\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Items per page.","title":"Size"},"index":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page index, starting at 0.","title":"Index"},"sort":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Sort as field,ASC or field,DESC (default resourceSetName,ASC).","title":"Sort"}},"required":["region"],"title":"list_resource_setsArguments","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_managed_organizations":{"post":{"operationId":"list_managed_organizations","summary":"List the organizations a managing (MSSP) organization administers, with id, name, external id and region. Use for \"Which","description":"List the organizations a managing (MSSP) organization administers, with id, name, external id and region. Use for \"Which customer organizations do I manage in Rapid7\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Rapid7 region code of your data: us, us2, us3, eu, ca, au, ap, aps2 or me1 (the first part of your Insight platform URL).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Items per page.","title":"Size"},"index":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page index, starting at 0.","title":"Index"}},"required":["region"],"title":"list_managed_organizationsArguments","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}}}}