MCPBundler Docs
MCPBundler Docs
Back to marketplaceGetting StartedAuthenticationTutorial - Bundle to Connected Agent
API Reference
Agent A2A Tools
Agent Channels
Agent Configuration (Staging)
Agent Configuration (Versions)
Agent Tools
Agents
Auth
Billing
Bundler
Bundler Tool
Bundles
Call Campaigns
Catalog
Conversations
Credentials
Deployments
Discover
Embedding
Fleet
Knowledge Bases
LLM
MCP Listings
Approve Schema RevisionCreate Draft ListingSubmit New VersionDelete Draft ListingDiscard Tool OverrideGet MCP ListingMy ListingsGet Schema Revision DetailList Tool OverridesList Schema RevisionsPreview MCP CapabilitiesUpsert Auth SchemesRefresh MCP CapabilitiesReject Schema RevisionSearch MCP ListingsSet Tool OverrideSubmit for ReviewUpdate Listing
Media
OAuth Clients
OAuth2
Observability
Organisations
Realtime
Reviews
Roadmap
SCIM
STT
Suppression
Triggers
TTS
Users
Utils
Voices
Webhooks
Workflows
API ReferenceMCP Listings

Update Listing

PUT
/v1/mcp/{listing_id}

Update an existing listing.

Authorization: caller must own the listing, or be an admin/owner of the listing's organisation (enforced by _get_owned_listing); returns 403 if neither, 404 if it does not exist.

Published public listings are immutable here - changes must go through a new version submission instead of a direct patch. Private and org-scoped listings remain directly editable after publishing since they skip the review queue entirely.

If this patch flips block_private_bundle_mixing from False to True, every existing BundleEntry for this listing sitting in a personal (non-org) bundle is deleted in the same transaction as the field update - see BundleProvider.remove_from_personal_bundles.

Args: listing_id: UUID of the listing to update. body: Partial update; only fields explicitly set are applied.

Authorization

OAuth2AuthorizationCodeBearer
AuthorizationBearer <token>

In: header

Path Parameters

listing_id*Listing Id
Formatuuid

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 PUT "https://example.com/v1/mcp/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "namespace": "string",  "visibility": "public",  "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",  "block_private_bundle_mixing": false,  "title": "string",  "short_description": "string",  "status": "string",  "transport": "string",  "pricing": "string",  "icon_bg_color": "string",  "icon_text_color": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "category": {    "id": 0,    "name": "string",    "slug": "string",    "description": "string",    "icon": "string",    "mcp_count": 0  }}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}

Submit for Review

Previous Page

Media

Endpoints in the Media group.

title?|null
short_description?|null
readme_content?string|null
category_id?integer|null
transport?|null
pricing?|null
provider_name?|null
maturity_level?|null
source_url?|null
homepage_url?|null
documentation_url?|null
support_url?|null
license?|null
dpa_available?boolean|null
dpa_url?|null
tags?array<string>|null
icon_bg_color?|null
icon_text_color?|null
auth_mode?|null
preferred_auth_type?|null
mcp_endpoint_url?|null
mcp_schema_endpoint_url?|null
mcp_webhook_url?|null
mcp_webhook_secret?|

Shared secret used to HMAC-sign requests to mcp_webhook_url.

pooled?boolean|null
oauth_client_id?|null
oauth_auth_url?|null
oauth_token_url?|null
oauth_default_scope?|null
oauth_client_secret?|

OAuth2 confidential-client secret, required by providers whose client type is not a public/PKCE-only client.

supported_auth_modes?array<>|null
auth_schemes?array<>|null
master_credential?||

Publisher's RUNTIME credential; the str form is a deprecated bearer token.

system_credential?|

Publisher's SYSTEM credential for schema refresh and pinging.

catalog_credential?|

Serialized credential JSON for MCPbundler system ops.

block_private_bundle_mixing?boolean|null
openapi_spec_url?|null