# Graphql To Typescript — REST API endpoint `graphql-to-typescript`

Convert a GraphQL SDL schema into TypeScript type definitions and return the generated code with counts of emitted types, enums, and inputs. Object and interface types become interfaces (or type aliases), enums become TypeScript enums, input types are included by default. Non-null fields (!) are required; nullable fields become optional and accept null. Built-in scalars map to string, number, and boolean.

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/graphql-to-typescript/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/graphql-to-typescript/
- Same tool on the other surface: https://findutils.com/mcp/graphql-to-typescript/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/graphql-to-typescript/execute \
  -H "Content-Type: application/json" \
  -d '{
    "schema": "type User {\n  id: ID!\n  name: String\n}\n\nenum Role {\n  ADMIN\n  USER\n}"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/graphql-to-typescript
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `schema` | string | yes | GraphQL schema in SDL (type, input, enum definitions). |
| `use_interfaces` | boolean | no | Emit "interface X {}" instead of "type X = {}". Default: true. Default: `true`. |
| `add_exports` | boolean | no | Prefix every declaration with "export". Default: true. Default: `true`. |
| `use_readonly` | boolean | no | Mark every field readonly. Default: false. Default: `false`. |
| `generate_input_types` | boolean | no | Also emit GraphQL input types. Default: true. Default: `true`. |

Example arguments (verified):

```json
{
  "schema": "type User {\n  id: ID!\n  name: String\n}\n\nenum Role {\n  ADMIN\n  USER\n}"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:graphql_to_typescript`. Full MCP reference: https://findutils.com/mcp/graphql-to-typescript/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt