Flowteller API MCP Server

This is an MCP (Model Context Protocol) server for the Flowteller API. It allows AI clients (like Claude Desktop) to natively interact with the Flowteller backend to search for trips, find locations, and manage bookings.

Installation & Setup for Claude Desktop

Because this project is hosted publicly on GitHub, you do not need to clone it to your computer! You can run it directly using uvx.

1. Install uv (if you haven't already):

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Configure Claude Desktop: Open your Claude Desktop configuration file:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   Add the following configuration, inserting your actual API key:

   {
     "mcpServers": {
       "flowteller": {
         "command": "uv",
         "args": [
           "--directory",
           "/Users/whoisladleo/Work/flowteller/mcp",
           "run",
           "flowteller-mcp"
        ],
        "env": {
          "FLOWTELLER_API_URL": "http://localhost:8000/api",
          "FLOWTELLER_MCP_API_KEY": "your_secure_mcp_api_key_here"
        }
      }
    }
     }

   

3. **Restart Claude Desktop.** You should now see the Flowteller tools and prompts available!

## Testing Locally (Inspector)
If you are developing or modifying the code locally, you can use the interactive MCP Inspector UI:
```bash
npx @modelcontextprotocol/inspector uv run app/server.py