MCP providers
Register an MCP provider
Register an org-level upstream MCP server (http transport, org visibility) and mint its bearer grant key. The grant key is returned exactly once and is never retrievable afterward; upstream header values go in and never come back. Rejected with 409 while any agent already enables an MCP server under the requested name — agents bind by name, so a new provider must not silently capture existing selections.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
orgId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/orgs/string/mcp-providers" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "url": "string" }'{ "id": "string", "name": "string", "kind": "string", "transport": "string", "url": "string", "service": "string", "visibility": "string", "sharedWith": [ "string" ], "ui": true, "createdBy": "string", "canEdit": true, "canManageSharing": true, "headerNames": [ "string" ], "auth": "string", "oauth": { "status": "string", "issuer": "string", "scopes": [ "string" ], "clientSource": "string", "expiresAt": "string" }, "createdAt": "string", "grantKey": "string"}