> ## Documentation Index > Fetch the complete documentation index at: https://docs.pomerado.ai/llms.txt > Use this file to discover all available pages before exploring further. # List integrations > List integrations: each one is a website's tools, published as its own MCP. By default this lists the public catalog. With mine=true, it lists only my integrations: those holding a tool you created or own. * **Callers:** an API key, an MCP OAuth token or a Dashboard session. * **Permission:** `tools:read`. * **Effect:** Changes nothing. * **Errors:** only the [errors any request can get](/errors). ## OpenAPI ````yaml /api-reference/openapi.json get /v1/integrations openapi: 3.1.0 info: title: Pomerado API version: '1' description: >- Run and build website tools, follow their jobs, and manage logins, API keys and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth token or a Dashboard session as a Bearer token. servers: - url: https://api.pomerado.ai security: [] tags: - name: account x-group: Account - name: api_keys x-group: API keys - name: connected_apps x-group: Connected apps - name: usage x-group: Usage - name: quota x-group: Quota - name: billing x-group: Billing - name: integrations x-group: Integrations - name: connect x-group: Connect - name: logins x-group: Saved logins - name: two_factor x-group: 2FA - name: login_access x-group: Login access - name: tools x-group: Tools - name: webhooks x-group: Webhooks - name: runs x-group: Runs - name: builds x-group: Builds - name: jobs x-group: Jobs - name: files x-group: Files - name: team x-group: Team paths: /v1/integrations: get: tags: - integrations summary: List integrations description: >- List integrations: each one is a website's tools, published as its own MCP. operationId: integrations.list parameters: - name: cursor in: query required: false description: The next_cursor of the previous page schema: type: string - name: limit in: query required: false description: Items per page, 1 to 100 (default 20) schema: type: string - name: mine in: query required: false description: >- true: only integrations holding a tool you created or own, each with only those tools schema: type: string enum: - 'true' - 'false' - name: query in: query required: false description: >- Words that must all appear in the integration's name, site, description or tools schema: type: string responses: '200': description: One page of integrations content: application/json: schema: type: object required: - data - next_cursor properties: data: type: array items: $ref: '#/components/schemas/Integration' next_cursor: anyOf: - type: string - type: 'null' additionalProperties: false '400': description: invalid_request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: unauthorized, reauthentication_required content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: forbidden content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: internal_error content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: temporarily_unavailable content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearer: [] components: schemas: Integration: type: object required: - id - name - description - site_url - visibility - owned_by_me - status - mcp_url - keyless_mcp_url - mcp_server_name - tools - created_at - updated_at properties: id: $ref: '#/components/schemas/integration_id' name: type: string description: The site's everyday name, such as Instacart description: type: string description: What the site is, in a sentence site_url: anyOf: - type: string - type: 'null' description: The site's https origin; null for an offline integration visibility: type: string enum: - public - private owned_by_me: type: boolean description: Whether it holds a tool you created or own status: type: string enum: - setting_up - ready - failed - disabled - not_hosted description: >- Its MCP's state: ready, setting_up, failed (Pomerado retries), disabled, or not_hosted when this deployment hosts none. Its tools run through the Pomerado MCP and REST in every state. mcp_url: anyOf: - type: string - type: 'null' description: Its MCP endpoint once ready; GET /v1/connect sets up a client keyless_mcp_url: anyOf: - type: string - type: 'null' description: >- Its MCP's URL for use without signing in; null unless the integration is public and ready mcp_server_name: anyOf: - type: string - type: 'null' description: Its MCP's name in client configs, such as instacart tools: type: array items: type: object required: - id - name - description - effect - login_required properties: id: $ref: '#/components/schemas/tool_id' name: type: string description: type: string effect: type: string enum: - read - write login_required: type: boolean additionalProperties: false created_at: $ref: '#/components/schemas/Date' updated_at: $ref: '#/components/schemas/DateFromString' additionalProperties: false Error: type: object required: - error properties: error: type: object required: - code - message - retryable - docs_url properties: code: type: string message: type: string retryable: type: boolean docs_url: type: string details: type: object required: [] properties: {} additionalProperties: $id: /schemas/unknown additionalProperties: false additionalProperties: false integration_id: type: string description: 'an integration ID: int_ and 32 lowercase hex digits' examples: - int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 tool_id: type: string description: 'a tool ID: tool_ and 32 lowercase hex digits' examples: - tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 Date: type: string description: a string to be decoded into a Date DateFromString: type: string description: a string to be decoded into a Date securitySchemes: bearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.