MCP Integration

Agile Flights exposes a Model Context Protocol (MCP) server so you can interact with your flights, teams, and analytics directly from AI tools like Claude, Cursor, Windsurf, and other MCP-compatible clients.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external tools and data sources. Instead of copy-pasting information between your project management tool and your AI assistant, MCP gives the assistant direct access to read and act on your data - with your permission.

Requirements

• A Team or Enterprise plan
• An MCP-compatible client (Claude Desktop, Claude Code, Cursor, Stilla, Windsurf, etc.)

Connecting Your AI Tool

The MCP server URL is:

https://mcp.agile.flights/mcp

The server uses the Streamable HTTP transport with OAuth authentication. Most MCP clients handle the OAuth flow automatically - you just need to provide the URL and sign in when prompted.

Claude Desktop

Open your Claude Desktop configuration file (claude_desktop_config.json) and add the following to the mcpServers section:

{
  "mcpServers": {
    "agile-flights": {
      "type": "streamable-http",
      "url": "https://mcp.agile.flights/mcp"
    }
  }
}

Restart Claude Desktop. On first use, a browser window will open asking you to sign in to Agile Flights. After authentication, Claude will have access to your flight data.

Claude Code

Run the following command to add the Agile Flights MCP server:

claude mcp add agile-flights -t streamable-http https://mcp.agile.flights/mcp

Claude Code will handle the OAuth flow in your browser when the tools are first used.

Cursor and Windsurf

Both Cursor and Windsurf support MCP servers through their settings. Add a new MCP server with:

• Name: Agile Flights
• Transport: Streamable HTTP (or HTTP)
• URL: https://mcp.agile.flights/mcp

The OAuth sign-in flow will open in your browser when the connection is first established.

Stilla

In Stilla, go to Settings > Integrations and add a new MCP server with the URL:

https://mcp.agile.flights/mcp

Stilla will handle the OAuth sign-in flow in your browser. Once connected, you can mention @Stilla in any channel and ask about your flights, teams, and analytics directly.

Available Tools

Once connected, your AI assistant can use the following tool categories:

• Teams - list teams, view team details and members
• Flights - list and view flights including crew, crates, and status
• Analytics - team analytics including flight velocity, status breakdowns, and throughput
• North Stars - list strategic objectives and view alignment reports
• Audit - review recent activity logs

Authentication Flow

The MCP server uses OAuth 2.0 for authentication. The flow works as follows:

1. Your AI client sends a request to the MCP server
2. The server redirects you to the Agile Flights sign-in page
3. You sign in using any supported method (Google, GitHub, email, or magic link)
4. The server verifies your plan tier and grants access
5. Your AI client receives an access token and can make requests on your behalf

The access token is scoped to your user account and respects the same permissions as the web app. You can only access data for organisations and teams you belong to.

Troubleshooting

Connection times out

Make sure you are using https:// (not http://) and that the URL points to /mcp - not /authorize. The /authorize endpoint is for OAuth only and does not accept MCP transport requests.

MCP access requires a Team or Enterprise plan

The MCP integration is available on paid plans only. If you see this error, check your plan at Settings > Billing in the app or visit app.agile.flights/settings.

Authentication expired

OAuth tokens expire after a period of inactivity. Most MCP clients will automatically prompt you to re-authenticate. If your client shows a persistent auth error, try removing and re-adding the MCP server configuration.