Arthur MCPArthur MCP
Dashboard
How it worksFeaturesDocsEarly accessGitHubDashboard

How to Import an OpenAPI Spec

Turn an existing OpenAPI/Swagger definition into a server with one tool per endpoint, without defining anything by hand.

Steps

  1. Go to New Server and choose Import OpenAPI/Swagger spec.

    Open the New server wizard at data-source selection

    Select REST API as the server source

  2. Upload your spec file (JSON or YAML), or paste its URL.

    Continue to the server details step

  3. Name the server. Optionally turn on AI-assisted improvements to get better tool names, descriptions, and schemas — see AI Providers.

    Name the server that will receive the imported specification

    Open the OpenAPI and Postman import interface

    Frame the OpenAPI upload area and accepted file types

  4. Review the operations Arthur found, then create the server.

    Show the API base URL used when importing or discovering a specification

Confirm it worked

The server opens on its Tools tab with one tool per imported endpoint, matching the operation count in your spec.

Good to know

  • If the API needs a credential, store it as a Secret and reference it in the server's upstream auth config rather than pasting it in directly.
  • Got an updated version of the same spec later? Use How to Re-import an Updated API Spec instead of rebuilding the server.

Related

Tutorial video