Skip to content
MCP server

Typeship

Manage Typeship from an agent: generate CLIs, MCP servers and SDKs from an API spec

Install
Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally or Remotely
Version
0.23.0
Listing updated
1 day ago

About Typeship

Typeship is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

This is the MCP server for Typeship's own API, so an agent can manage the product that turns an OpenAPI, Swagger or GraphQL spec into a command-line tool, a hosted MCP server and TypeScript, Python and Go SDKs. Typeship then keeps those outputs current through reviewed pull requests as the spec changes. The server resolves a spec, diagnoses it and keeps each chosen target up to date.

It keeps the tool surface small: search_docs, read_docs and execute, where reading an operation first returns its arguments, an example and a safety classification. Arguments are checked before anything reaches the API, results can be trimmed with a fields parameter, and a read-only flag or a subset list restricts what the server can do.

It runs three ways, as an npm package on Node 20 or later over stdio, or as hosted full, public and read-only HTTP endpoints at typeship.dev. A Typeship API key is needed for the local server.

Install

Run in a terminal

claude mcp add --transport http typeship https://typeship.dev/mcp

Add to Settings → Connectors → Add custom connector

https://typeship.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "typeship": {
      "url": "https://typeship.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "typeship": {
      "serverUrl": "https://typeship.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "typeship": {
      "type": "http",
      "url": "https://typeship.dev/mcp"
    }
  }
}

Configuration

  • TYPESHIP_TOKENAPI key from the Typeship console (ak_...).

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

search_docs
Finds operations and guides.
read_docs
Reads an operation's schema, example and safety class.
execute
Calls an operation with typed arguments.

What it does

Compact tool surface
Uses search, read and execute instead of many tools.
Safety classification
Read an operation to see if it is destructive.
Read-only mode
A flag or a hosted endpoint blocks writes.
Argument validation
Checks inputs before they reach the API.
Hosted or local
Run via npx or connect to typeship.dev.
Result trimming
A fields option keeps only needed keys.

Good for

  • Generate a CLI and SDKs for an API from its spec
  • Diagnose problems in an OpenAPI document
  • Keep generated clients current after API changes
  • Give an agent read-only access to a project's status

Pricing

Freemium

Free for one project (25 operations per target); Pro includes 150 operations per target, then $1 per operation per month

Prices change. Check typeship.dev before you buy.

Typeship FAQ

Which spec formats are supported?

Swagger 2.0, OpenAPI 3.0 and 3.1, and GraphQL.

Does it need a key?

The local server reads TYPESHIP_TOKEN, an API key from the Typeship console.

What is free?

One project with the first 25 API operations per target.

Can I stop it making changes?

Yes, use --read-only or the read-only hosted endpoint.

Is Typeship free?

Typeship has a free plan, with paid plans for more usage or features.

How do I add Typeship to Claude Code?

Run this command in your terminal: claude mcp add --transport http typeship https://typeship.dev/mcp

What are the best alternatives to Typeship?

The closest alternatives to Typeship are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Typeship

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools