---
title: "List deployed resources"
method: GET
path: "/v0/deployments"
tags: ["deployments"]
---

# List deployed resources

`GET /v0/deployments`

Retrieve all deployed resources (MCP servers, agents) with their configurations. Optionally filter by resource type.

## Query parameters

- `platform` string — Filter by provider platform type (for OSS: local or kubernetes)
- `providerId` string — Filter by provider instance ID
- `resourceType` 'mcp' | 'agent' — Filter by resource type (mcp, agent)
- `status` string — Filter by deployment status
- `origin` 'managed' | 'discovered' — Filter by deployment origin (managed, discovered)
- `resourceName` string — Case-insensitive substring filter on resource name

## Response `200`

OK

- DeploymentsListResponseBody
  - `deployments` Deployment[], required — List of deployed servers
    - `deployedAt` string, date-time, required
    - `env` object, required
    - `error` string
    - `id` string, required
    - `origin` string, required
    - `preferRemote` boolean, required
    - `providerConfig` object
    - `providerId` string
    - `providerMetadata` object
    - `resourceType` string, required
    - `serverName` string, required
    - `status` string, required
    - `updatedAt` string, date-time, required
    - `version` string, required

## Other responses

- `default` — Error

## Changes

- **2026-03-02** `cd40eb4cf442` — 2 breaking, 8 warning, 9 info
  - the `query` request parameter `origin` was restricted to a list of enum values
  - removed the required property `items` from the response with the `200` status
  - deleted the `query` request parameter `cursor`
  - deleted the `query` request parameter `includeTerminating`
  - …15 more

[Change history](https://skmtc.dev/agentregistry-dev/apis/agentregistry/changes/v0/deployments/get.md)

---

[API](https://skmtc.dev/agentregistry-dev/apis/agentregistry.md) · [All operations](https://skmtc.dev/agentregistry-dev/apis/agentregistry/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentregistry-dev/agentregistry/revisions/cd40eb4cf442/schema)