JustCall MCP Server
by saaslabsco
justcall.ts•26.3 kB
import {
ListCallsDto,
GetCallDto,
UpdateCallDto,
GetCallJourneyDto,
ListUsersDto,
GetUserDto,
UpdateUserAvailabilityDto,
ListContactsDto,
GetContactDto,
CreateContactDto,
UpdateContactDto,
UpdateContactStatusDto,
AddContactsBlacklistDto,
ListSmsDto,
SendSmsDto,
GetSmsDto,
CheckSmsReplyDto,
ListSmsThreadsDto,
GetSmsThreadDto,
AddTagToThreadDto,
ListNumbersDto,
GetNumberDto,
// Webhook DTOs
ListWebhooksDto,
CreateWebhookDto,
// User Groups DTOs
GetVoiceAgentDto,
ListVoiceAgentsDto,
InitiateVoiceAgentCallDto,
// SMS Tags DTOs
ListSmsTagsDto,
GetSmsTagDto,
CreateSmsTagDto,
DeleteSmsTagDto,
// Analytics DTOs
GetAgentAnalyticsDto,
GetAccountAnalyticsDto,
GetNumberAnalyticsDto,
// User Groups DTOs
ListUserGroupsDto,
GetUserGroupDto,
// Appointments DTOs
ListAppointmentSlotsDto,
CreateAppointmentDto,
GetAppointmentDto,
// WhatsApp DTOs
ListWhatsAppMessagesDto,
GetWhatsAppMessageDto,
SendWhatsAppMessageDto,
ListWhatsAppTemplatesDto,
CheckWhatsAppReplyDto,
// AI DTOs
ListCallsAiDataDto,
GetCallAiDataDto,
ListMeetingsAiDataDto,
GetMeetingAiDataDto,
ListBlacklistContactsDto,
} from "../dto/justcall/index.js";
import { BaseApiService } from "./base-api.js";
import axios from "axios";
export class JustCallApiService extends BaseApiService {
constructor() {
super(
axios.create({
baseURL: "https://api.justcall.io",
timeout: 60000,
headers: {
"Content-Type": "application/json",
},
}),
);
}
protected getServiceName(): string {
return "justcall-api-service";
}
private getAuthHeaders(token: string) {
return {
"Content-Type": "application/json",
Authorization: `${token}`,
};
}
// Calls Endpoints
listCalls(dto: ListCallsDto & { context?: any }): Promise<any> {
const { authToken, context, ...queryParams } = dto;
// Build query parameters
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
if (Array.isArray(value)) {
acc[key] = value;
} else {
acc[key] = value.toString();
}
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
getCall(dto: GetCallDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, id, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
updateCall(dto: UpdateCallDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, id, ...requestBody } = dto;
const url = `/v2.1/calls/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "PUT",
data: requestBody,
context,
});
}
getCallJourney(dto: GetCallJourneyDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, id } = dto;
const url = `/v2.1/calls/${id}/journey`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
// Users/Agents Endpoints
listUsers(dto: ListUsersDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/users`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
getUser(dto: GetUserDto & { context?: any }): Promise<any> {
const { companyId, authToken, id, context } = dto;
const url = `/v2.1/users/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
updateUserAvailability(dto: UpdateUserAvailabilityDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/users/availability`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "PUT",
data: requestBody,
});
}
// Contacts Endpoints
listContacts(dto: ListContactsDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/contacts`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
getContact(dto: GetContactDto & { context?: any }): Promise<any> {
const { authToken, id, context } = dto;
const url = `/v2.1/contacts/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
createContact(dto: CreateContactDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/contacts`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
context,
});
}
updateContact(dto: UpdateContactDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/contacts`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "PUT",
data: requestBody,
context,
});
}
updateContactStatus(dto: UpdateContactStatusDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/contacts/status`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "PUT",
data: requestBody,
});
}
addContactsBlacklist(dto: AddContactsBlacklistDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/contacts/bulk-add/blacklist`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
});
}
listBlacklistContacts(
dto: ListBlacklistContactsDto & { context?: any },
): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/contacts/blacklist`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
// SMS/Text Messages Endpoints
listSms(dto: ListSmsDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/texts`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
sendSms(dto: SendSmsDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/texts/new`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
context,
});
}
getSms(dto: GetSmsDto & { context?: any }): Promise<any> {
const { companyId, authToken, id, context } = dto;
const url = `/v2.1/texts/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
checkSmsReply(dto: CheckSmsReplyDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...bodyParams } = dto;
const url = `/v2.1/texts/checkreply`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
method: "POST",
headers,
data: bodyParams,
context,
});
}
// Numbers Endpoints
listNumbers(dto: ListNumbersDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/phone-numbers`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
getNumber(dto: GetNumberDto & { context?: any }): Promise<any> {
const { companyId, authToken, id, context } = dto;
const url = `/v2.1/phone-numbers/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
// Teams Endpoints
// Webhook Endpoints
listWebhooks(dto: ListWebhooksDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/webhooks`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
createWebhook(dto: CreateWebhookDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/webhooks`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
context,
});
}
// Voicemail Endpoints
// IVR Endpoints
// Conference Endpoints
// Call Queue Endpoints
// SMS Tags Endpoints
listSmsTags(dto: ListSmsTagsDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/texts/tags`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
getSmsTag(dto: GetSmsTagDto & { context?: any }): Promise<any> {
const { companyId, authToken, id, context } = dto;
const url = `/v2.1/texts/tags/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
createSmsTag(dto: CreateSmsTagDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/texts/tags`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
context,
});
}
deleteSmsTag(dto: DeleteSmsTagDto & { context?: any }): Promise<any> {
const { companyId, authToken, id, context } = dto;
const url = `/v2.1/texts/tags/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "DELETE",
context,
});
}
// SMS Threads Endpoints
listSmsThreads(dto: ListSmsThreadsDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/texts/threads`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
getSmsThread(dto: GetSmsThreadDto): Promise<any> {
const { companyId, authToken, thread_id, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/texts/threads/${thread_id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
addTagToThread(dto: AddTagToThreadDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/texts/threads/tag`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
});
}
// Additional Team Endpoints
// deleteTeam method removed per user request
// deleteContact method removed per user request
// Additional Webhook Endpoints
// deleteWebhook method removed per user request
// deleteNumber method removed per user request
// Additional Conference Endpoints
// deleteConference method removed per user request
// deleteRecording method removed per user request
// Call Tags Endpoints
// Agent Analytics Endpoints
getAgentAnalytics(
dto: GetAgentAnalyticsDto & { context?: any },
): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value;
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls/analytics/agent`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
params,
context,
});
}
/**
* Get account analytics
* @param dto - GetAccountAnalyticsDto
* @returns Promise<any>
*/
getAccountAnalytics(
dto: GetAccountAnalyticsDto & { context?: any },
): Promise<any> {
const { authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value;
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls/analytics/account`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, params, context });
}
getNumberAnalytics(
dto: GetNumberAnalyticsDto & { context?: any },
): Promise<any> {
const { authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value;
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls/analytics/number`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, params, context });
}
/**
* Get voice agent data
* @param dto
* @returns
*/
getVoiceAgentData(dto: GetVoiceAgentDto & { context?: any }): Promise<any> {
const { authToken, context, id } = dto;
const url = `/v2.1/calls/${id}/voice-agent`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers, context });
}
// Voice Agents Endpoints
listVoiceAgents(dto: ListVoiceAgentsDto & { context?: any }): Promise<any> {
const { companyId, authToken, context, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/voice-agents/list`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers, context });
}
initiateVoiceAgentCall(
dto: InitiateVoiceAgentCallDto & { context?: any },
): Promise<any> {
const { companyId, authToken, context, ...requestBody } = dto;
const url = `/v2.1/voice-agents/calls`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
context,
});
}
// User Groups Endpoints
listUserGroups(dto: ListUserGroupsDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/user_groups`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
getUserGroup(dto: GetUserGroupDto): Promise<any> {
const { companyId, authToken, id } = dto;
const url = `/v2.1/user_groups/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers });
}
// Appointments Endpoints
listAppointmentSlots(dto: ListAppointmentSlotsDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/appointments/available-slots`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
createAppointment(dto: CreateAppointmentDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/appointments`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
});
}
getAppointment(dto: GetAppointmentDto): Promise<any> {
const { companyId, authToken, id } = dto;
const url = `/v2.1/appointments/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { headers });
}
// WhatsApp Endpoints
listWhatsAppMessages(dto: ListWhatsAppMessagesDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
if (Array.isArray(value)) {
acc[key] = value;
} else {
acc[key] = value.toString();
}
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/whatsapp/messages`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
getWhatsAppMessage(dto: GetWhatsAppMessageDto): Promise<any> {
const { companyId, authToken, id, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/whatsapp/messages/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
sendWhatsAppMessage(dto: SendWhatsAppMessageDto): Promise<any> {
const { companyId, authToken, ...requestBody } = dto;
const url = `/v2.1/whatsapp/messages/send`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, {
headers,
method: "POST",
data: requestBody,
});
}
listWhatsAppTemplates(dto: ListWhatsAppTemplatesDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/whatsapp/messages/templates`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
checkWhatsAppReply(dto: CheckWhatsAppReplyDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = value.toString();
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/whatsapp/messages/check-reply`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
// JustCall AI Endpoints
listCallsAiData(dto: ListCallsAiDataDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
if (typeof value === "boolean") {
acc[key] = value.toString();
} else if (Array.isArray(value)) {
acc[key] = value;
} else {
acc[key] = value.toString();
}
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls_ai`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
getCallAiData(dto: GetCallAiDataDto): Promise<any> {
const { companyId, authToken, id, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
if (typeof value === "boolean") {
acc[key] = value.toString();
} else {
acc[key] = value.toString();
}
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/calls_ai/${id}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
listMeetingsAiData(dto: ListMeetingsAiDataDto): Promise<any> {
const { companyId, authToken, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
if (typeof value === "boolean") {
acc[key] = value.toString();
} else if (Array.isArray(value)) {
acc[key] = value;
} else {
acc[key] = value.toString();
}
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/meetings_ai`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
getMeetingAiData(dto: GetMeetingAiDataDto): Promise<any> {
const { companyId, authToken, instance_sid, ...queryParams } = dto;
const params = Object.entries(queryParams)
.filter(([_, value]) => value !== undefined && value !== null)
.reduce(
(acc, [key, value]) => {
acc[key] = String(value);
return acc;
},
{} as Record<string, any>,
);
const url = `/v2.1/meetings_ai/${instance_sid}`;
const headers = this.getAuthHeaders(authToken as string);
return this.executeApiCall(url, { params, headers });
}
}
Latest Blog Posts
- MCP Moves to the Linux Foundation: Neutral Stewardship for Agentic InfrastructureBy Om-Shree-0709 on .mcpanthropicLinux Foundation
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/saaslabsco/justcall-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server