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
Agents
Attachments
Auth
Billing
bundler
Bundler
Bundler Tool
Bundles
Call Campaigns
Catalog
Conversations
Credentials
Deployments
Discover
Fleet
Genesys
Insights
internal
Knowledge Base Website Sources
Knowledge Bases
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
Organisation roles
Organisations
Providers
Reviews
Roadmap
SCIM
Simulation Tests
Suppression
Triggers
TTS
Users
Utils
Visitors
Voices
Webhooks
Workflows
API ReferenceMCP Listings

Update Listing

PUT
/v1/mcp/{listing_id}

Update an existing listing.

Authorization (enforced by _get_owned_listing): the caller must own a private listing, or, for an org listing, hold listings:manage in its organisation (listings:create covers the caller's own); returns 403 if neither, 404 if it does not exist or the caller cannot read it.

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