Getting started

Skmtc turns OpenAPI schemas into live, searchable API documentation. Your coding agent can find an API, read its operations through MCP, or fetch the same docs as compact Markdown. When you publish a new schema revision, the docs track it. To get generated code for an API as a GitHub pull request, see Open a pull request with generated code.

You can explore public APIs without an account. To publish your own schema, sign up with GitHub. Your first sign-in creates a personal account; an organization is optional.

Point your agent at SkmtcCopy Anchor Link

Paste this into Claude Code or another coding agent. The agent should inspect your repository before suggesting a schema file or destination.

The documentation URLs above also serve plain Markdown, so an agent can read them without rendering the website. Public API pages have the same option: append .md to an API or operation URL, or request Accept: text/markdown from its HTML URL. An API's llms.txt lists its operations for an agent to navigate.

Connect Claude CodeCopy Anchor Link

Add the Skmtc MCP server to your client once:

claude mcp add --transport http skmtc https://mcp.skmtc.dev/mcp/publish

{
  "mcpServers": {
    "skmtc": {
      "url": "https://mcp.skmtc.dev/mcp"
    }
  }
}

{
  "servers": {
    "skmtc": {
      "type": "http",
      "url": "https://mcp.skmtc.dev/mcp"
    }
  }
}

Customize > Connectors > Add > Add custom connector
Enter the name Skmtc and the URL https://mcp.skmtc.dev/mcp
Authentication: No sign-in

In Claude Code, run /mcp, select skmtc, and follow the browser sign-in. Sign in with GitHub and approve publish:schemas. Claude Code stores and refreshes its own authorization; you do not need to create or paste a token. Your personal account can publish to itself or to an organization where you are a member. To connect Claude Desktop, Cursor or VS Code, or to see what each tool does, see Connect your agent over MCP.

Hello world: publish a private APICopy Anchor Link

Save this as openapi.yaml:

openapi: 3.1.0
info:
  title: Hello world
  version: 1.0.0
paths:
  /hello:
    get:
      operationId: getHello
      summary: Say hello
      responses:
        '200':
          description: A greeting
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string

Choose your destination explicitly before sending:

Account:    ada
API slug:   hello-world
Visibility: private

Replace ada with your Skmtc account handle. Ask your connected Claude Code agent to publish openapi.yaml with these exact values. It should show them to you before calling create_upload_url, which gives it an upload URL for the file:

Publish openapi.yaml to account ada, API slug hello-world, visibility private.
Show me the destination and ask for confirmation before publishing. Then
verify the new revision and give me the API page and Markdown URL.

Open https://skmtc.dev/ada/apis/hello-world while signed in. The public Markdown convention is https://skmtc.dev/ada/apis/hello-world.md. A private API stays private, including its Markdown view.

Other ways to publishCopy Anchor Link

To publish without an agent, open Your APIs, select New API, and upload an OpenAPI JSON or YAML file. Check the account, slug, and visibility before selecting Add API. The browser form starts at Private.

For a direct REST call, use a token with publish:schemas and follow Publish an API. For automation, follow Publish from CI.