Dixa MCP Server
A FastMCP server implementation for the Dixa API, providing resources and tools for managing conversations and tags.
Features
- Resources
- Search conversations
- Get conversation details
- Get conversation notes
- Get conversation messages
- Get available tags
- Tools
- Add tags to conversations
- Remove tags from conversations
Project Structure
Configuration
The server requires the following environment variables:
DIXA_API_KEY
: Your Dixa API keyDIXA_API_BASE_URL
(optional): Override the default API URL (defaults to 'https://dev.dixa.io/v1')
Usage
- Set up environment variables:
- Start the server:Copy
This will run your server with mcp-cli
for testing and debugging your MCP server in the terminal.
Inspect with MCP Inspector
Another way is to use the official MCP Inspector
to inspect your server with a Web UI:
FAQ
How to use with Claude Desktop?
Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:
Development
Adding a New Resource
- Create a schema in
src/schemas/
- Create the resource in
src/resources/
- Add the resource to
src/dixa.ts
Example resource:
Adding a New Tool
- Create the tool in
src/tools/
- Add the tool to
src/dixa.ts
Example tool:
Error Handling
The project uses custom error classes:
DixaError
: Base error class for API errorsDixaValidationError
: For response validation failures
Showcase
Note
If you've developed a server using FastMCP, please submit a PR to showcase it here!
- https://github.com/apinetwork/piapi-mcp-server
- https://github.com/Meeting-Baas/meeting-mcp - Meeting BaaS MCP server that enables AI assistants to create meeting bots, search transcripts, and manage recording data
Acknowledgements
- FastMCP is inspired by the Python implementation by Jonathan Lowin.
- Parts of codebase were adopted from LiteMCP.
- Parts of codebase were adopted from Model Context protocolでSSEをやってみる.
Contributing
- Follow the existing patterns for resources and tools
- Add proper JSDoc documentation
- Use the shared utilities in
types.ts
andconfig.ts
- Update the README if adding new features
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A FastMCP server implementation for the Dixa API, enabling AI assistants to search, retrieve, and manage customer conversation data and tags.
Related MCP Servers
- AsecurityFlicenseAqualityThis server provides access to the Perplexity AI API, enabling interaction through chatting, searching, and documentation retrieval within MCP-based systems.Last updated -52JavaScript
- -securityFlicense-qualityAn MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.Last updated -119Python
- -security-license-qualityAn MCP server that integrates Apifox API documentation with AI assistants, allowing AI to extract and understand API information from Apifox projects.Last updated -91TypeScript
- -securityFlicense-qualityAn MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.Last updated -Python