TutorialsMcp servers

Create an OpenAPI-based MCP server

Copy page

Overview

Gram by Speakeasy turns any OpenAPI specification into a production-ready MCP server. Upload your API spec, and Gram automatically generates tool definitions, handles hosting and authentication, and deploys your server- so you can focus on building powerful agents.

Visit Gram's documentation for a complete guide.

Step 1: Sign up for a Gram account

Sign up for a free Gram account.

Step 2: Upload your OpenAPI document

Navigate to Toolsets in the Gram dashboard sidebar (under Create) and click Get Started

Upload your OpenAPI document, provide a descriptive name, and click Upload

Gram extracts URL paths, HTTP methods, request schemas, and operation descriptions from your OpenAPI document to generate tool definitions.

Note
Note

Gram works with partial OpenAPI documents as long as key elements (paths, methods, schemas, descriptions) are present.

Step 3: Ship 🚢

Your MCP server is ready to ship! Open the MCP page, and open your MCP server by clicking it. Click Enable to allow the MCP server to handle requests.

Step 4: Add authentication (optional)

To add authentication, set the appropriate environment variables. See Step 3 in the Gram documentation for details.

Next steps