MCPBundler Docs
MCPBundler Docs
Back to marketplaceGetting StartedAuthenticationTutorial - Bundle to Connected Agent
API Reference
Auth
Bundler
Bundles
Catalog
Deployments
Create DeploymentRemove Entry CredentialDelete DeploymentGenerate TokenGet DeploymentLink Vault EntryList Credential MetadataList DeploymentsRename DeploymentRevoke TokenUnlink Vault EntryUpdate Router ConfigWrite Credential
Discover
LLM
MCP Listing Claims
MCP Listings
OAuth2
Observability
Organisations
Reviews
Roadmap
SCIM
Users
Utils
Vault
Webhooks
API ReferenceDeployments

Create Deployment

A deployment is a running instance of a bundle, bound to the caller. The full lifecycle spans several endpoints:

  1. POST /deployments - snapshot the bundle's current entries into a new deployment. No credentials or tokens exist yet.
  2. PUT /deployments/{deployment_id}/credentials/{entry_id} (or the /vault variant to link a reusable org/personal vault entry instead) - supply auth for each entry that needs it.
  3. For entries backed by OAuth2 rather than a static credential, use POST /oauth2/initiate instead - see that endpoint's docs for the flow.
  4. POST /deployments/{deployment_id}/tokens - issue a bearer token an agent uses to actually connect through the bundler.

Deleting the deployment does not delete the underlying bundle.

POST
/v1/deployments

Create a deployment binding the caller to a bundle.

Authorization: the target bundle must be public, or owned by the caller; otherwise this returns 404 (existence of a private bundle owned by someone else is not disclosed).

The bundle's current entries are snapshotted into the deployment at creation time via the provider; no credentials or tokens exist yet.

Authorization

OAuth2AuthorizationCodeBearer
AuthorizationBearer <token>

In: header

Query Parameters

verify_locally?Verify Locally
Defaulttrue

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/deployments" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "bundle_id": "fc6f5a67-caa1-4339-9c14-a67826143b60"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "bundle_id": "fc6f5a67-caa1-4339-9c14-a67826143b60",  "bundle_name": "string",  "created_at": "2019-08-24T14:15:22Z",  "health": "grey",  "token_count": 0,  "router_enabled": false,  "router_key_id": "1c1c460b-a98a-4785-9c9d-f5e0af128ea5",  "router_key_name": "",  "loading_strategy": "eager",  "router_set_context": true,  "router_rolling_window": false,  "entry_snapshot_ids": [    "10534ae3-c1b4-4bd7-83a7-a1b919bc924a"  ],  "credentials": [],  "tokens": []}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}

Deployments

Endpoints in the Deployments group.

Remove Entry Credential

Next Page

name*Name
Length1 <= length <= 128
bundle_id*Bundle Id
Formatuuid
router_enabled?Router Enabled
Defaultfalse
router_key_id?|null
loading_strategy?Loading Strategy
Default"eager"
router_set_context?Router Set Context
Defaulttrue
router_rolling_window?Router Rolling Window
Defaultfalse
entry_snapshot_ids?array<>