ticket_tailor_mcp_server
This project is a Python MCP wrapper for Ticket Tailor API, facilitating the interaction through various features such as event retrieval and order fetching. It is built on FastMCP to ensure a smooth integration with other applications, with ongoing developments to expand its capabilities.
Ticket Tailor API Integration
A Python MCP wrapper for the Ticket Tailor API that makes it easy for LLM's to interact with the Ticket Tailor API. Still very early stages but the groundwork has all been done. Now its about building out functions for the various end points. We can also build out specific tools that dont just get/post/patch data but perform work on the data. I have functions to create events in code elsewhere that i will bring in later.
Features
- Retrieve events with flexible filtering options
- Fetch orders with comprehensive search parameters
- Built on FastMCP for easy integration into your applications
Installation
# Clone the repository
git clone https://github.com/shakermakerk/ticket_tailor_mcp_server.git
cd ticket_tailor_mcp_server
# Install dependencies
pip install -r requirements.txt
Setup
- Create a
.env
file in the root directory based on the.env_example
file to add your Ticket Tailor API key
Usage
To use with Cursor (Not that we would generally want to do this):
edit mcp.json to add the following
"tt-events": {
"type": "command",
"command": "mcp run /src/ticket_tailor/ticket_tailor_funcs.py" # you may need to edit this path
}
Advanced Usage
Using with our own agents. It depends on the agentic framework that you're using but you generally pass the MCP server in as a tool. Some frameworks like Openai-Agents SDK that are naturally async require some helper functions. I can provide examples if reqested. in ticket_tailor_mcp_server/src/ticket_tailor/example_langgraph_agent.py you will see a simple example using langchain react agents (not langgraph).
API Reference
See the src/ticket_tailor
directory for implementation details.
Development Roadmap
We're working on implementing more Ticket Tailor API endpoints. See our for:
- Prioritized list of endpoints to implement
- Current implementation status
- Guidelines for adding new endpoints
If you'd like to contribute, please check the roadmap for endpoints that need implementation.
Contributing
Contributions are welcome! Here's how you can help:
- Check the for endpoints that need implementation
- Review the for guidelines
- Create an issue to track your work
- Submit a pull request with your implementation
We especially welcome contributions that implement new API endpoints following the patterns established in the existing code.
License
This project is licensed under the MIT License - see the file for details.