fakestore_add_user
Add a new user to the Fake Store API for testing or demonstration purposes. This simulation tool accepts user details like email, username, address, and contact information.
Instructions
Add a new user (simulation - does not persist)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | User email address | ||
| username | Yes | Username | |
| password | Yes | User password | |
| firstname | Yes | First name | |
| lastname | Yes | Last name | |
| city | Yes | City | |
| street | Yes | Street name | |
| number | Yes | Street number | |
| zipcode | Yes | ZIP code | |
| lat | Yes | Latitude | |
| long | Yes | Longitude | |
| phone | Yes | Phone number |
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';