Typeship — Claude Code MCP server: what it does, how to install
Connects your agent to Typeship to build and maintain typed SDKs, CLIs, and MCP servers directly from OpenAPI or GraphQL specs.
claude mcp add --transport http typeship https://typeship.dev/mcpWhat Typeship does
Typeship turns API contracts like OpenAPI and GraphQL into code targets, including client libraries and CLI binaries. The server keeps its interface minimal with three primary actions: search_docs, read_docs, and execute. The model inspects operation schemas and usage examples before sending payloads.
Parameter validation happens locally against the underlying schema. Mistyped fields return an immediate error with recovery steps. Running locally via npx demands Node.js 20 or newer, and the server fails immediately if TYPESHIP_TOKEN is missing from the environment. A hosted HTTP alternative is also available.
What it helps with
- generate typed SDKs from GraphQL or OpenAPI files
- build client CLIs and MCP servers from an API schema
- diagnose syntax and schema issues in API contracts
- restrict agent capabilities to safe operations with
--read-only
Example prompts for the agent
- Search Typeship docs for operations that parse OpenAPI specifications
- Inspect the parameters and safety rating for this operation using
read_docs - Build a typed client target using the latest schema file
How to install Typeship
1Platform CLI: remote server
claude mcp add --transport http typeship https://typeship.dev/mcp2Platform CLI
claude mcp add --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> --transport stdio typeship -- npx -y @typeship-ax/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add typeship --url https://typeship.dev/mcp2Platform CLI
codex mcp add typeship --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> -- npx -y @typeship-ax/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"typeship": {
"url": "https://typeship.dev/mcp"
}
}
}{
"mcpServers": {
"typeship": {
"command": "npx",
"args": [
"-y",
"@typeship-ax/mcp"
],
"env": {
"TYPESHIP_TOKEN": "<TYPESHIP_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"typeship": {
"type": "http",
"url": "https://typeship.dev/mcp"
}
}
}{
"servers": {
"typeship": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@typeship-ax/mcp"
],
"env": {
"TYPESHIP_TOKEN": "<TYPESHIP_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http typeship https://typeship.dev/mcp2Platform CLI
gemini mcp add -e TYPESHIP_TOKEN=<TYPESHIP_TOKEN> typeship npx -y @typeship-ax/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Typeship
How to install Typeship in Claude Code?
To use the hosted endpoint, run claude mcp add --transport http typeship https://typeship.dev/mcp. For local execution, run claude mcp add --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> --transport stdio typeship -- npx -y @typeship-ax/mcp.
What does the Typeship MCP server do?
It provides search_docs, read_docs, and execute tools to interface with the Typeship platform. This lets your assistant inspect API definitions and build typed SDKs or CLIs.
What are the requirements for running Typeship locally?
You need Node.js 20+ and a valid TYPESHIP_TOKEN passed in the environment settings. You can also enforce a read-only mode with the --read-only argument.
