set_certificate
Enable or update SSL/TLS certificates for websites using the ESA MCP Server by specifying site ID, certificate type, and details like content, private key, or cloud certificate ID.
Instructions
Configures whether to enable certificates and update certificate information for a website.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| casId | No | The ID of the cloud certificate. | |
| certificate | No | The content of the certificate. | |
| id | No | The ID of the certificate. | |
| name | No | The name of the certificate. | |
| privateKey | No | The private key of the certificate. | |
| region | No | The region. | |
| siteId | Yes | The website ID. Reference Value Source: list_sites | |
| type | Yes | The type of certificate. Possible values: - cas (Cloud Certificate) - upload (Custom Upload Certificate) |
Implementation Reference
- src/tools/site/certificate.ts:193-202 (handler)MCP tool handler: executes the tool logic by calling api.setCertificate with the provided arguments and returns the JSON stringified response.export const set_certificate = async (request: CallToolRequest) => { const res = await api.setCertificate( request.params.arguments as SetCertificateRequest, ); return { content: [{ type: 'text', text: JSON.stringify(res) }], success: true, }; };
- src/tools/list-esa-function.ts:143-150 (registration)Registers the set_certificate tool (via SET_CERTIFICATE_TOOL) in the CERTIFICATE_LIST array used for MCP tool exposure.export const CERTIFICATE_LIST = [ SET_CERTIFICATE_TOOL, APPLY_CERTIFICATE_TOOL, GET_CERTIFICATE_TOOL, DELETE_CERTIFICATE_TOOL, LIST_CERTIFICATES_TOOL, GET_CERTIFICATE_QUOTA_TOOL, ];
- src/tools/list-esa-function.ts:164-208 (registration)Maps the tool name 'set_certificate' to its handler function in the esaHandlers object.export const esaHandlers: ToolHandlers = { site_active_list, site_match, site_route_list, site_record_list, routine_create, routine_code_commit, routine_delete, routine_list, routine_get, routine_code_deploy, routine_route_list, deployment_delete, route_create, route_delete, route_update, route_get, er_record_create, er_record_delete, er_record_list, html_deploy, create_site, update_site_pause, get_site_pause, create_site_mx_record, create_site_ns_record, create_site_txt_record, create_site_cname_record, create_site_a_or_aaaa_record, update_record, list_records, get_record, delete_record, update_ipv6, get_ipv6, update_managed_transform, get_managed_transform, set_certificate, apply_certificate, get_certificate, delete_certificate, list_certificates, get_certificate_quota, list_sites, };
- src/tools/site/certificate.ts:13-61 (schema)Tool definition with input schema for validation.export const SET_CERTIFICATE_TOOL: Tool = { name: 'set_certificate', description: 'Configures whether to enable certificates and update certificate information for a website.', inputSchema: { type: 'object', properties: { siteId: { type: 'number', description: 'The website ID. Reference Value Source: list_sites', examples: ['123456****'], }, name: { type: 'string', description: 'The name of the certificate.', }, casId: { type: 'number', description: 'The ID of the cloud certificate.', }, type: { type: 'string', description: 'The type of certificate. Possible values: - cas (Cloud Certificate) - upload (Custom Upload Certificate)', enum: ['cas', 'upload'], }, certificate: { type: 'string', description: 'The content of the certificate.', }, privateKey: { type: 'string', description: 'The private key of the certificate.', }, region: { type: 'string', description: 'The region.', example: 'cn-hangzhou', }, id: { type: 'string', description: 'The ID of the certificate.', example: '30001303', }, }, required: ['siteId', 'type'], annotations: {}, }, };
- src/utils/service.ts:498-507 (helper)Underlying API wrapper method that wraps the Alibaba Cloud ESA client call for setCertificate.setCertificate(params: SetCertificateRequest) { const request = new SetCertificateRequest(params); return this.callApi( this.client.setCertificate.bind(this.client) as ApiMethod< SetCertificateRequest, SetCertificateResponse >, request, ); }