# @justcall/mcp-server
## 1.2.1
### Patch Changes
- 14dd998: Fix CSP error for JustCall domains in Open AI Apps SDK
## 1.2.0
### Minor Changes
- feat: add support for open ai apps sdk
- Add OpenAI Apps SDK widget metadata to call tools (list_calls, get_call)
- Register UI widget resources for calls list and call details views
- Add HTML widget templates for displaying call data
- Update tool handlers to support OpenAI widget output templates
- Add TypeScript declarations for HTML module imports
- Enhance utils to support widget-aware tool responses
This enables rich UI widgets in OpenAI Apps when using JustCall MCP tools,
allowing users to view call data in interactive, formatted interfaces.
## 1.1.1
### Patch Changes
- 9c12b88: IN-7992: Added list all blacklist contacts in justcall contacts tools
## 1.1.0
### Minor Changes
- Add readOnlyHint metadata to all read-only tools across the JustCall and
Sales Dialer tool sets. This enhancement helps MCP clients identify which
tools perform read-only operations, enabling better tool selection and
usage patterns.
The readOnlyHint is set to true for all tools that only retrieve data
without modifying state, including:
- Call retrieval tools (list_calls, get_call, get_call_journey, etc.)
- Contact listing and retrieval tools
- Analytics tools
- SMS/WhatsApp message retrieval tools
- User and user group listing tools
- Webhook listing tools
- Number listing tools
- Appointment slot listing tools
- AI analysis retrieval tools
- Voice agent listing tools
- Sales Dialer read-only operations
This change improves tool discoverability and helps AI agents make more
informed decisions about which tools to use for different operations.
## 1.0.2
### Patch Changes
- Add Website Url in server.json
## 1.0.1
### Patch Changes
Update README for oauth and add logo to server.json
## 1.0.0
### Major Changes
- Add OAuth2 authentication support for enhanced security
- Implement OAuth2 authorization server metadata endpoint (`/.well-known/oauth-authorization-server`)
- Add OAuth2 configuration (S256 code challenge method)
- Protect MCP and SSE endpoints with Bearer token authentication
- Add token validation middleware for `/mcp`, `/sse`, and `/sse/message` endpoints
- Support authorization code grant flow with client secret authentication
- Add utility function to extract auth tokens from request context
## 0.0.11
### Patch Changes
- Add extensive new functionality across JustCall and SalesDialer platforms including:
- JustCall AI analysis (transcription, summaries, insights for calls/meetings)
- Appointments and calendar management
- WhatsApp messaging templates and communications
- User groups and availability management
- Enhanced contacts with status tracking and bulk operations
- SMS threads with tagging support
- Voice agent call initiation
- SalesDialer contacts, calls, and campaign management
- Custom fields support across platforms
## 0.0.10
### Patch Changes
- 6c1796d: fix: Updated tool titles and descriptions; modified base API to fetch client info
## 0.0.9
### Patch Changes
- Updated Base API to support client info details when available.
## 0.0.6
### Patch Changes
- fix: Correct phone numbers and contacts update endpoint URLs
## 0.0.5
### Patch Changes
- fix: Align API parameters with JustCall Developer API specification
## 0.0.4
### Patch Changes
- 37b3c39: Publish to MCP official registry and add server.json
## 0.0.3
### Patch Changes
- Add tools for Account and number analytics
- New tools for retrieving account-level analytics data
- Enhanced analytics capabilities for tracking number-specific metrics
- Improved analytics DTO and schema structure for better type safety
- Enhanced SDK with additional analytics endpoints
## 0.0.2
### Patch Changes
- Add comprehensive MCP tools for JustCall and SalesDialer APIs
- 20+ API endpoints across JustCall and SalesDialer
- Call management: List, get, update calls, track call journeys, and voice agent interactions
- Contact management: Full CRUD operations (list, get, create, update)
- SMS operations: Send SMS, list messages, get message details, check replies, manage tags
- User management: Complete user operations (list, get, create, update)
- Number management: Tools to list and retrieve phone numbers
- Webhook management: Create and list webhooks for event notifications
- Analytics: Agent performance analytics and SalesDialer campaign analytics
- Campaign management: Full campaign operations (list, get, create, update)
- Restructured project with organized DTO structure
- Implemented Zod schemas for robust input validation
- Added SDK services (JustCallApiService, SalesDialerApiService, BaseApiService)
- Enhanced type safety and error handling across all API endpoints
## 0.0.1
### Patch Changes
- Initial release of JustCall MCP Server
- Basic server setup with Model Context Protocol support
- Initial call listing functionality
- Docker configuration for containerized deployment
- Cloudflare Workers support for edge deployment
- Environment-based configuration with dotenv