← Back to Documentation

Quick Start Guide

Get your first MCP server running in under 5 minutes

Total Time: ~5 minutes

📋 Prerequisites

  • An TransitIA account (sign up at /signup)
  • An OpenAPI/Swagger specification file (JSON or YAML)
  • Node.js 18+ installed on your machine
  • Claude Desktop or another MCP-compatible client

Step 1: Upload Your API Spec

⏱️ 30 seconds

Import your OpenAPI/Swagger specification (JSON or YAML format)

# Or paste the URL directly
https://api.example.com/openapi.json

Step 2: Configure Tools

⏱️ 2 minutes

Select which endpoints to expose as MCP tools and customize descriptions

  • AI-assisted tool selection
  • Customize tool names and descriptions
  • Configure parameter handling
  • Set authentication requirements

Step 3: Generate & Download

⏱️ Instant

Get your ready-to-use MCP server code

# Your generated package structure
my-api-mcp/
├── src/
│   ├── index.ts
│   ├── tools/
│   └── types/
├── package.json
└── README.md

Step 4: Run Your MCP Server

⏱️ 1 minute

Install dependencies and start your MCP server

cd my-api-mcp
npm install
npm start

# Server running on stdio
# Ready to connect to Claude Desktop!

🎉 You're All Set!

Your MCP server is now running and ready to be used by AI agents. Here's what you can do next:

Need help? We're here to assist!