Create Field

Instructions

Implementation Reference

• src/tools/fields.ts:9-55 (registration)

  Registration of the 'create_field' tool on the MCP server with input schema definition and handler function

  // ── create_field ──────────────────────────────────────────────────
  server.registerTool("create_field", {
    title: "Create Field",
    description: "Add a new field to a collection",
    inputSchema: {
      collection_slug: z
        .string()
        .describe("The slug of the collection to add the field to"),
      type: z
        .string()
        .describe(
          "Field type: text, number, richtext, boolean, date, media, relation, select, longtext, group, etc."
        ),
      label: z.string().describe("Display label (max 60 chars)"),
      name: z
        .string()
        .describe("Field identifier in kebab-case (max 60 chars)"),
      description: z.string().optional().describe("Field description"),
      placeholder: z.string().optional().describe("Placeholder text"),
      options: z
        .record(z.string(), z.unknown())
        .optional()
        .describe(
          "Field-specific options (e.g. { repeatable: true } for group fields)"
        ),
      validations: z
        .record(z.string(), z.unknown())
        .optional()
        .describe(
          "Validation rules (e.g. { required: { status: true, message: 'Required' } })"
        ),
      parent_field_id: z
        .number()
        .optional()
        .describe(
          "Internal ID of a group field to nest this field under"
        ),
    },
  }, async ({ collection_slug, ...fieldData }) => {
    const result = await client.post(
      `/collections/${collection_slug}/fields`,
      fieldData
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  });

• src/tools/fields.ts:13-46 (schema)

  Input schema for 'create_field' using Zod: collection_slug, type, label, name, description, placeholder, options, validations, parent_field_id

  inputSchema: {
    collection_slug: z
      .string()
      .describe("The slug of the collection to add the field to"),
    type: z
      .string()
      .describe(
        "Field type: text, number, richtext, boolean, date, media, relation, select, longtext, group, etc."
      ),
    label: z.string().describe("Display label (max 60 chars)"),
    name: z
      .string()
      .describe("Field identifier in kebab-case (max 60 chars)"),
    description: z.string().optional().describe("Field description"),
    placeholder: z.string().optional().describe("Placeholder text"),
    options: z
      .record(z.string(), z.unknown())
      .optional()
      .describe(
        "Field-specific options (e.g. { repeatable: true } for group fields)"
      ),
    validations: z
      .record(z.string(), z.unknown())
      .optional()
      .describe(
        "Validation rules (e.g. { required: { status: true, message: 'Required' } })"
      ),
    parent_field_id: z
      .number()
      .optional()
      .describe(
        "Internal ID of a group field to nest this field under"
      ),
  },

• src/tools/fields.ts:47-55 (handler)

  Handler function that extracts collection_slug from params and POSTs the rest to /collections/{slug}/fields via the ElmapiClient

  }, async ({ collection_slug, ...fieldData }) => {
    const result = await client.post(
      `/collections/${collection_slug}/fields`,
      fieldData
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  });

• src/client.ts:114-122 (helper)

  ElmapiClient.post() helper - the HTTP POST method used by the create_field handler to call the API

  async post(path: string, body?: unknown): Promise<unknown> {
    const response = await fetch(`${this.baseUrl}${path}`, {
      method: "POST",
      headers: this.headers(),
      body: body ? JSON.stringify(body) : undefined,
    });
  
    return this.handleResponse(response);
  }

• src/index.ts:37-37 (registration)

  Top-level registration: registerFieldTools(server, client) is called to register all field tools including create_field

  registerFieldTools(server, client);