microCMS MCP Server

Instructions

Implementation Reference

• src/tools/get-list-meta.ts:31-43 (handler)

  Handler function that parses tool parameters, validates endpoint, constructs options, and calls the client getListMeta function to fetch list metadata.

  export async function handleGetListMeta(params: ToolParameters) {
      const { endpoint, limit, offset } = params;
  
      if (!endpoint) {
          throw new Error('endpoint is required');
      }
  
      const options: { limit?: number; offset?: number } = {};
      if (limit !== undefined) options.limit = limit;
      if (offset !== undefined) options.offset = offset;
  
      return await getListMeta(endpoint, options);
  }

• src/tools/get-list-meta.ts:5-29 (schema)

  Tool definition including name, description, and inputSchema for parameter validation (endpoint required, optional limit/offset).

  export const getListMetaTool: Tool = {
      name: 'microcms_get_list_meta',
      description: 'Get a list of contents with metadata from microCMS Management API. IMPORTANT: Use this tool ONLY when the user message contains "メタ" (meta) or "メタ情報" (metadata). This API returns metadata information such as status, createdBy, updatedBy, reservationTime, closedAt, and customStatus that are not available in the regular content API. For regular content retrieval, use microcms_get_list instead.',
      inputSchema: {
          type: 'object',
          properties: {
              endpoint: {
                  type: 'string',
                  description: 'Content type name (e.g., "blogs", "news")',
              },
              limit: {
                  type: 'number',
                  description: 'Number of contents to retrieve (default: 10, max: 100)',
                  minimum: 1,
                  maximum: 100,
              },
              offset: {
                  type: 'number',
                  description: 'Offset for pagination (default: 0)',
                  minimum: 0,
              },
          },
          required: ['endpoint'],
      },
  };

• src/server.ts:85-87 (registration)

  Switch case in the CallToolRequest handler that routes calls to this tool to its handleGetListMeta function.

  case 'microcms_get_list_meta':
    result = await handleGetListMeta(params);
    break;

• src/server.ts:51-51 (registration)

  The tool object is included in the array returned by the ListToolsRequest handler, making it discoverable.

  getListMetaTool,

• src/client.ts:212-235 (helper)

  Core client function that fetches the list of contents with metadata from microCMS Management API using fetch, handling limit and offset.

  export async function getListMeta(
    endpoint: string,
    options?: { limit?: number; offset?: number }
  ): Promise<any> {
    const queryParams = new URLSearchParams();
    if (options?.limit) queryParams.append('limit', options.limit.toString());
    if (options?.offset) queryParams.append('offset', options.offset.toString());
  
    const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/contents/${endpoint}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
  
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'X-MICROCMS-API-KEY': config.apiKey,
      },
    });
  
    if (!response.ok) {
      const errorText = await response.text();
      throw new Error(`Failed to get contents list: ${response.status} ${response.statusText} - ${errorText}`);
    }
  
    return await response.json();
  }