Typeship is an MCP server published by dev.typeship, hosted at typeship.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including packages_generate, packages_download, search_docs, read_docs, query_docs.
Generate a typed SDK, CLI, and MCP server from any OpenAPI or GraphQL spec, and keep them current.
949 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Generate a package. Returns one generated package without creating a Project. POST /generate Credential optional.
Schema too large to show here (20,459 characters).
{
"name": "packages_generate",
"title": "Generate a package",
"description": "Generate a package. Returns one generated package without creating a Project. POST /generate Credential optional.",
"inputSchema": {
"truncated": true,
"chars": 20459
},
"outputSchema": {
"type": "object",
"properties": {
"claim": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"expires_at": {
"type": "string",
"format": "date-time"
}
}
}
],
"description": "Anonymous, URL-sourced generations only. A link a signed-in person can open to turn this run into a project in their organization (same Spec, Target, and config). Lasts seven days. Null for inline Specs; absent on keyed calls."
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"mode": {
"enum": [
"100644",
"100755"
],
"type": "string",
"default": "100644",
"description": "Exact Git file mode. Omitted one-shot outputs are regular files."
},
"path": {
"type": "string",
"description": "Repo-relative path inside the generated package."
},
"content": {
"type": "string"
}
}
}
},
"object": {
"type": "string",
"const": "package",
"description": "One generated package. It has no ID: download it with download.url before download.expires_at."
},
"coverage": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"reason": {
"enum": [
"anonymous",
"free_plan"
],
"type": "string",
"description": "Present when a plan or anonymous limit omitted operations."
},
"omitted": {
"type": "integer",
"minimum": 0
},
"generated": {
"type": "integer",
"minimum": 0
},
"signup_url": {
"type": "string",
"format": "uri",
"description": "Sign-up link for anonymous capped runs."
},
"upgrade_url": {
"type": "string",
"format": "uri",
"description": "Upgrade link for capped signed-in runs."
},
"omitted_operations": {
"type": "array",
"items": {
"type": "string"
},
"description": "METHOD/path identities of operations omitted from the package."
}
}
},
"download": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of the downloaded ZIP bytes."
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"file_count": {
"type": "integer",
"minimum": 0
},
"size_bytes": {
"type": "integer",
"minimum": 0
}
},
"description": "Complete package ZIP from this exact result. Present on requests with Idempotency-Key, including automatic CLI, MCP, and SDK keys. Download before expires_at, verify sha256, and extract into an empty directory. Anyone with this URL can download the package; keep it private. Reading does not generate again or extend the 24-hour replay window."
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Stable machine-readable warning code."
},
"message": {
"type": "string",
"description": "Human-readable explanation."
},
"operation": {
"type": "string",
"description": "METHOD/path of the affected operation, when applicable."
}
}
}
},
"request_id": {
"type": "string",
"pattern": "^req_[a-z0-9]{16}$",
"examples": [
"req_3k8m1v6q9p2d7h4c"
],
"description": "Server-generated identifier used to correlate this response with Typeship logs."
}
}
},
"annotations": {
"title": "Generate a package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Download a generated package. Download the complete ZIP referenced by `packages_generate`'s `download.url`. GET /generate/download No credential needed.
| Parameter | Type | Description |
|---|---|---|
| token * | string | Private download token from download.url in the generation result. |
| fields | array | Result keys to keep, as dotted paths (e.g. ["id","name"]). Omit for the whole result. Keeps responses small. |
{
"name": "packages_download",
"title": "Download a generated package",
"description": "Download a generated package. Download the complete ZIP referenced by `packages_generate`'s `download.url`. GET /generate/download No credential needed.",
"inputSchema": {
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"example": "parcel_download_example_token_1234567890123",
"pattern": "^[A-Za-z0-9_-]{43}$",
"maxLength": 43,
"minLength": 43,
"description": "Private download token from download.url in the generation result."
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Result keys to keep, as dotted paths (e.g. [\"id\",\"name\"]). Omit for the whole result. Keeps responses small."
}
}
},
"annotations": {
"title": "Download a generated package",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search this API's reference (operations, parameters) and, when a docs site is configured, its guides. Best matches first; page through with page.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of reference matches (10 per page), default 1 |
| query * | string | The task in a few words, e.g. "assign issue" or "list calls" |
{
"name": "search_docs",
"description": "Search this API's reference (operations, parameters) and, when a docs site is configured, its guides. Best matches first; page through with page.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page of reference matches (10 per page), default 1"
},
"query": {
"type": "string",
"description": "The task in a few words, e.g. \"assign issue\" or \"list calls\""
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read a documentation page: an operation reference (a tool name, or dotted "resource.method"), a named input type such as a filter, or a docs-site guide page by name or URL. Long pages come in parts; pass the offset a part ends with to continue.
| Parameter | Type | Description |
|---|---|---|
| page * | string | |
| path | string | A dotted argument path within the operation or type, e.g. "filter.team.key": that field's type, with its named type's fields or values |
| offset | integer | Character offset to continue a long page from, default 0 |
| schema | boolean | Also return the operation's complete input and output JSON Schemas, default false |
{
"name": "read_docs",
"description": "Read a documentation page: an operation reference (a tool name, or dotted \"resource.method\"), a named input type such as a filter, or a docs-site guide page by name or URL. Long pages come in parts; pass the offset a part ends with to continue.",
"inputSchema": {
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "string"
},
"path": {
"type": "string",
"description": "A dotted argument path within the operation or type, e.g. \"filter.team.key\": that field's type, with its named type's fields or values"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Character offset to continue a long page from, default 0"
},
"schema": {
"type": "boolean",
"description": "Also return the operation's complete input and output JSON Schemas, default false"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search every Typeship docs page and both references with a regular expression (case-insensitive) and get matching lines with their page and a little context. Use when search_docs is too coarse or you need every occurrence of a term, flag, or error message. GET llms-full.txt
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum matches to return (1 to 100). Default 30. |
| context | integer | Lines of context around each match (0 to 5). Default 1. |
| pattern * | string | A JavaScript regular expression, matched case-insensitively line by line. |
{
"name": "query_docs",
"title": "Grep the Typeship docs",
"description": "Search every Typeship docs page and both references with a regular expression (case-insensitive) and get matching lines with their page and a little context. Use when search_docs is too coarse or you need every occurrence of a term, flag, or error message. GET llms-full.txt",
"inputSchema": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum matches to return (1 to 100). Default 30."
},
"context": {
"type": "integer",
"maximum": 5,
"minimum": 0,
"description": "Lines of context around each match (0 to 5). Default 1."
},
"pattern": {
"type": "string",
"description": "A JavaScript regular expression, matched case-insensitively line by line."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Tell the Typeship team a docs page is wrong, missing, or unclear: the page (URL or title) and what you expected. Read by people; no reply comes back through this tool. POST docs feedback
| Parameter | Type | Description |
|---|---|---|
| page * | string | The page URL or title. |
| message * | string | What is wrong or missing, in one to five sentences. |
{
"name": "submit_docs_feedback",
"title": "Report a docs problem",
"description": "Tell the Typeship team a docs page is wrong, missing, or unclear: the page (URL or title) and what you expected. Read by people; no reply comes back through this tool. POST docs feedback",
"inputSchema": {
"type": "object",
"required": [
"page",
"message"
],
"properties": {
"page": {
"type": "string",
"description": "The page URL or title."
},
"message": {
"type": "string",
"description": "What is wrong or missing, in one to five sentences."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false
}
}Typeship turns an OpenAPI or GraphQL spec into a typed SDK (TypeScript, Python, Go), a CLI, and an MCP server, and keeps them current. Every operation of Typeship's API is a tool. Use search_docs before read_docs; read_docs takes an operation name or a docs page; query_docs greps every page with a regular expression; submit_docs_feedback tells the team a page is wrong. The secured endpoint binds OAuth access to the organization chosen during consent. An organization API key exposes every account tool; an OAuth connection exposes only the read, generate, and write capabilities approved during sign-in. Anonymous generation (the first 25 operations, rate limited per address) lives at /mcp/public. After packages_generate, download the complete package from download.url before download.expires_at, verify download.sha256, and extract into an empty directory. Keep the URL private. Do not repeat generation to retrieve files omitted by the result limit. For a stored generation, use generations_retrieve_file to read one file. Paginated tools return items, hasMore, and nextPage (the exact arguments for the following page). Pass fields (dotted paths) to keep only the result keys you need; unknown or mistyped arguments come back as an isError result listing each problem. Reference arguments marked in their schema accept an ID or an exact case-insensitive name, slug, key, or email; ambiguity returns named candidates and no fuzzy guess is made. If a tool errors with quota_exceeded, feature_not_available, or an anonymous limit, the response says where to sign up or upgrade; do not retry the same call.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.