# Typeship

> Typeship is a freemium MCP server for developer tools. Manage Typeship from an agent: generate CLIs, MCP servers and SDKs from an API spec. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web
- **Website:** https://typeship.dev
- **Repository:** https://github.com/typeship-ax/mcp
- **MCP Registry name:** dev.typeship/typeship
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://typeship.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "typeship": {
      "url": "https://typeship.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/typeship
