# TypeSpec

**Canonical:** https://apis.io/providers/typespec/  
**Website:** https://typespec.io  
**APIs profiled:** 6

TypeSpec is an API description language developed by Microsoft for defining API shapes that compile to OpenAPI, JSON Schema, Protobuf, and other output formats. It provides a language and toolchain for describing REST APIs, gRPC services, and data schemas in a type-safe, composable way with built-in support for versioning, metadata, and extensibility via decorators and libraries.

## Kin Score — 23.5 / 100 (emerging)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 23.5).

| Facet | Score |
|---|---|
| Discoverability | 64.8 |
| Contract Quality | 15.5 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 26.3 |
| Developer Ergonomics | 17.9 |
| Commercial Clarity | 15.8 |
| Access Clarity | 15.8 |

## Agent readiness — 7.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | no |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | documented |
| Auth Clarity | no |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium — onboarding: unknown, pricing: freemium, trial: no (confidence: medium).

## APIs (6)

- **TypeSpec Compiler** — The TypeSpec compiler processes `.tsp` TypeSpec files and emits output for configured emitters (OpenAPI, JSON Schema, Protobuf, etc.). It provides a programmatic Node.js/TypeScr...
- **TypeSpec OpenAPI Emitter** — The TypeSpec OpenAPI emitter converts TypeSpec definitions to OpenAPI 3.0 specifications. It supports HTTP operations, request/response bodies, security schemes, and API version...
- **TypeSpec JSON Schema Emitter** — Emits JSON Schema documents from TypeSpec model definitions, enabling data validation and type documentation workflows.
- **TypeSpec Protobuf Emitter** — Emits Protocol Buffer `.proto` files from TypeSpec service definitions, enabling gRPC service generation from a single TypeSpec source.
- **TypeSpec HTTP Library** — The TypeSpec HTTP library provides decorators and types for describing HTTP REST APIs including routes, operations, request bodies, query parameters, headers, and response codes.
- **TypeSpec REST Library** — The TypeSpec REST library provides decorators for REST API patterns including resource operations (CRUD), collection operations, and standardized error response shapes.

## MCP servers (1)

- **MCP Server**

## Security (1)

- **Typespec Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Typespec Plans Pricing**

## Tags

API Design, Code Generation, OpenAPI, Protocol Buffers, Specification Language

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/typespec/). Scores are computed from the provider's own public artifacts under a published rubric.