JustCall MCP Server

import z from "zod"; // Contact Schemas export const ListContactsSchema = { across_team: z .boolean() .optional() .describe( "Send 'true' to fetch all contacts for all the agents from your JustCall account. Default value will be 'false'.", ), agent_ids: z .array(z.number()) .optional() .describe( "Add a list of agent_ids to fetch contacts associated with multiple agents at once.", ), contact_number: z.string().optional().describe("Phone number of the contact"), first_name: z.string().optional().describe("First name of the contact"), last_name: z.string().optional().describe("Last name of the contact"), status: z .array(z.enum(["blacklist", "dnd", "dnm"])) .optional() .describe( "Status of the contact from among the following - Blacklist, DND, DNM", ), per_page: z .number() .optional() .describe( "Number of contacts to be fetched per page. Default value is 50 and maximum value is 500.", ), page: z .number() .optional() .describe( "Page number for which contacts are to be fetched. Page number '0' indicates first page containing records.", ), order: z .enum(["asc", "desc"]) .optional() .describe( "Order in which the contacts list should appear based on the 'id' of the contact. Recently added contacts are represented by larger 'id' values. Defaults to DESC (descending order).", ), last_contact_id_fetched: z .number() .optional() .describe( "Id of the last contact fetched in the previous query. This Id ensures that you won't receive any duplicate data when using the `next_page_link` parameter.", ), }; export const CreateContactSchema = { first_name: z.string().describe("First name of the contact"), last_name: z.string().optional().describe("Last name of the contact"), contact_number: z.string().describe("Phone number of the contact"), other_numbers: z .array( z.object({ label: z.string(), number: z.string(), }), ) .optional() .describe("Other phone numbers associated with the contact"), extension: z .number() .optional() .describe("Assign an extension to the contact"), email: z.string().optional().describe("Email id of the contact"), company: z .string() .optional() .describe("Company with which the contact is associated"), address: z.string().optional().describe("Address of the contact"), notes: z .string() .optional() .describe("Additional information added for the contact in JustCall"), across_team: z .boolean() .optional() .describe( "Choose to add a contact for all agents or only for the account owner", ), agent_id: z .number() .optional() .describe( "Specify the agent_id to create contact only for a specific agent", ), agent_ids: z .array(z.string()) .optional() .describe( "Specify the agent_ids to create contact only for a specific agents", ), }; export const GetContactSchema = { id: z.number().describe("Unique id of the contact as generated by JustCall"), }; export const UpdateContactSchema = { id: z .number() .optional() .describe("Unique id of the contact as generated by JustCall"), contact_number: z .string() .optional() .describe("Primary phone number of the contact"), first_name: z.string().optional().describe("First name of the contact"), last_name: z.string().optional().describe("Last name of the contact"), other_numbers: z .array( z.object({ label: z.string(), number: z.string(), }), ) .optional() .describe("Other phone numbers associated with the contact"), email: z.string().optional().describe("Email id of the contact"), extension: z .number() .optional() .describe("Assign an extension to the contact"), company: z .string() .optional() .describe("Company with which the contact is associated"), address: z.string().optional().describe("Address of the contact"), notes: z .array( z.object({ note: z.string(), }), ) .optional() .describe("Additional notes for the contact"), across_team: z .boolean() .optional() .describe( "Choose to update a contact for all agents or only for the account owner", ), }; export const UpdateContactStatusSchema = { id: z .number() .optional() .describe("Unique id of the contact as generated by JustCall"), contact_number: z .string() .optional() .describe("Primary phone number of the contact"), add_to: z .array(z.enum(["blacklist", "dnd", "dnm"])) .optional() .describe( "Add the phone number to one or more lists from DND, DNM and Blacklist", ), remove_from: z .array(z.enum(["blacklist", "dnd", "dnm"])) .optional() .describe( "Remove the phone number from one or more lists from DND, DNM and Blacklist", ), across_team: z .boolean() .optional() .describe( "Choose to update a contact for all agents or only for the account owner", ), }; export const AddContactsBlacklistSchema = { contact_numbers: z .array(z.string()) .describe("List of contact numbers to be added to specified lists"), add_to: z .array(z.enum(["blacklist", "dnd", "dnm"])) .describe( "Add the contact numbers to one or more lists from DND, DNM and Blacklist", ), across_team: z .boolean() .optional() .describe( "Choose to add contacts to specified lists for all agents or only for the account owner", ), }; export const ListBlacklistContactsSchema = { across_team: z .boolean() .optional() .describe( "Send 'true' to fetch all blacklist contacts for all the agents from your JustCall account. Default value will be 'false'.", ), contact_number: z.string().optional().describe("Phone number of the contact"), first_name: z.string().optional().describe("First name of the contact"), last_name: z.string().optional().describe("Last name of the contact"), status: z .array(z.enum(["blacklist", "dnd", "dnm"])) .optional() .describe( "Status of the contact from among the following - Blacklist, DND, DNM", ), agent_ids: z .array(z.number()) .optional() .describe( "Add a list of agent_ids to fetch blacklist contacts associated with multiple agents at once.", ), per_page: z .number() .optional() .describe( "Number of blacklist contacts to be fetched per page. Default value is 50 and maximum value is 500.", ), page: z .number() .optional() .describe( "Page number for which blacklist contacts are to be fetched. Page number '0' indicates first page containing records.", ), order: z .enum(["asc", "desc"]) .optional() .describe( "Order in which the blacklist contacts list should appear based on the 'id' of the contact. Recently added blacklist contacts are represented by larger 'id' values. Defaults to DESC (descending order).", ), };