fakestore_add_user

Instructions

Implementation Reference

• src/tools/users.ts:41-107 (handler)

  Core handler function that validates input parameters and sends a POST request to the FakeStore API to simulate adding a new user.

  export async function addUser(args: {
    email: string;
    username: string;
    password: string;
    firstname: string;
    lastname: string;
    city: string;
    street: string;
    number: number;
    zipcode: string;
    lat: string;
    long: string;
    phone: string;
  }): Promise<User> {
    const {
      email,
      username,
      password,
      firstname,
      lastname,
      city,
      street,
      number,
      zipcode,
      lat,
      long,
      phone,
    } = args;
  
    // Basic validation
    validateEmail(email);
    validatePhone(phone);
  
    if (!username || typeof username !== 'string') {
      throw new Error('Username must be a non-empty string');
    }
    if (!password || typeof password !== 'string') {
      throw new Error('Password must be a non-empty string');
    }
    if (!firstname || typeof firstname !== 'string') {
      throw new Error('First name must be a non-empty string');
    }
    if (!lastname || typeof lastname !== 'string') {
      throw new Error('Last name must be a non-empty string');
    }
  
    return post<User>('/users', {
      email,
      username,
      password,
      name: {
        firstname,
        lastname,
      },
      address: {
        city,
        street,
        number,
        zipcode,
        geolocation: {
          lat,
          long,
        },
      },
      phone,
    });
  }

• src/tools/users.ts:227-284 (schema)

  Input schema definition for the fakestore_add_user tool, specifying properties, types, descriptions, and required fields.

  {
    name: 'fakestore_add_user',
    description: 'Add a new user (simulation - does not persist)',
    inputSchema: {
      type: 'object',
      properties: {
        email: {
          type: 'string',
          description: 'User email address',
        },
        username: {
          type: 'string',
          description: 'Username',
        },
        password: {
          type: 'string',
          description: 'User password',
        },
        firstname: {
          type: 'string',
          description: 'First name',
        },
        lastname: {
          type: 'string',
          description: 'Last name',
        },
        city: {
          type: 'string',
          description: 'City',
        },
        street: {
          type: 'string',
          description: 'Street name',
        },
        number: {
          type: 'number',
          description: 'Street number',
        },
        zipcode: {
          type: 'string',
          description: 'ZIP code',
        },
        lat: {
          type: 'string',
          description: 'Latitude',
        },
        long: {
          type: 'string',
          description: 'Longitude',
        },
        phone: {
          type: 'string',
          description: 'Phone number',
        },
      },
      required: ['email', 'username', 'password', 'firstname', 'lastname', 'city', 'street', 'number', 'zipcode', 'lat', 'long', 'phone'],
    },
  },

• src/index.ts:183-201 (registration)

  Registration and dispatch logic in the main CallToolRequestSchema handler that invokes the addUser function when the tool name matches.

  if (name === 'fakestore_add_user') {
    const result = await addUser(args as {
      email: string;
      username: string;
      password: string;
      firstname: string;
      lastname: string;
      city: string;
      street: string;
      number: number;
      zipcode: string;
      lat: string;
      long: string;
      phone: string;
    });
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
    };
  }

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

  Tool list registration where userTools (including fakestore_add_user schema) is combined and returned in ListToolsRequestSchema handler.

  tools: [...productTools, ...cartTools, ...userTools],

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

  Import statement that brings in the addUser handler and userTools (with schema) from users.ts.

  import { userTools, getAllUsers, getUserById, addUser, updateUser, deleteUser } from './tools/users.js';