get_record
Retrieve detailed DNS record configuration, including value, priority, and origin authentication for CNAME records, using the specified record ID from the ESA MCP Server.
Instructions
Queries the configuration of a single DNS record, such as the record value, priority, and origin authentication setting (exclusive to CNAME records).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recordId | Yes | The record ID, which can be obtained by calling ListRecords. |
Implementation Reference
- src/tools/site/record.ts:763-772 (handler)The primary handler function implementing the 'get_record' tool logic. It processes the tool call request, casts parameters to GetRecordRequest, invokes the API service, and returns a formatted text response containing the JSON-serialized result.export const get_record = async (request: CallToolRequest) => { const req = request.params.arguments as GetRecordRequest; const res = await api.getRecord(req); return { content: [{ type: 'text', text: JSON.stringify(res) }], success: true, }; };
- src/tools/site/record.ts:611-631 (schema)Defines the tool metadata, description, and input schema (requiring a numeric 'recordId') for validation in the MCP tool system.export const GET_RECORD_TOOL: Tool = { name: 'get_record', description: 'Queries the configuration of a single DNS record, such as the record value, priority, and origin authentication setting (exclusive to CNAME records).', inputSchema: { type: 'object', properties: { recordId: { type: 'number', description: 'The record ID, which can be obtained by calling ListRecords.', examples: [1234567890123], }, }, required: ['recordId'], annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, }, }, };
- src/tools/list-esa-function.ts:164-208 (registration)Registers the 'get_record' handler function in the central esaHandlers object, which maps tool names to their execution functions for the MCP server.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/list-esa-function.ts:125-139 (registration)Includes the GET_RECORD_TOOL in the ESA_OPENAPI_SITE_LIST array, likely used to register the tool specification with the MCP server.export const ESA_OPENAPI_SITE_LIST = [ LIST_SITES_TOOL, CREATE_SITE_TOOL, UPDATE_SITE_PAUSE_TOOL, GET_SITE_PAUSE_TOOL, UPDATE_RECORD_TOOL, CREATE_SITE_MX_RECORD_TOOL, CREATE_SITE_NS_RECORD_TOOL, CREATE_SITE_TXT_RECORD_TOOL, CREATE_SITE_CNAME_RECORD_TOOL, CREATE_SITE_A_OR_AAAA_RECORD_TOOL, DELETE_RECORD_TOOL, LIST_RECORDS_TOOL, GET_RECORD_TOOL, ];
- src/utils/service.ts:444-453 (helper)Helper service method that wraps the Alibaba Cloud ESA SDK client.getRecord call, handling request construction and runtime options.getRecord(params: GetRecordRequest) { const request = new GetRecordRequest(params); return this.callApi( this.client.getRecord.bind(this.client) as ApiMethod< GetRecordRequest, GetRecordResponse >, request, ); }