# tc39-mcp

> tc39-mcp is an open-source MCP server for developer tools. Structured, SHA-pinned lookup of the ECMAScript and Intl specs for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://mcp.xyzzylabs.ai/tc39
- **Repository:** https://github.com/xyzzylabs/tc39-mcp
- **MCP Registry name:** io.github.xyzzylabs/tc39-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Instead of grepping a 4 MB spec.html, an agent calls tools that return parsed JSON: algorithm steps as arrays, cross-references as ids and signatures as typed values. Coverage is ECMA-262 and ECMA-402, every released annual edition from ES2016 to ES2026 plus main, and each clause carries its upstream commit SHA and fetch time so a citation can be reproduced. Responses are deterministic functions of pinned spec data.

There are 19 tools in five namespaces: clause, spec, test262 and proposal lookups, plus grammar, tables and syntax-directed operation indexes. Search ranks exact abstract-operation identifiers first, cross-reference lookups work in both directions and across the two specs, and diff and history tools compare editions or walk the upstream git log. A test262 search runs over an index built from a local checkout.

It runs locally with npx tc39-mcp, caching snapshots under ~/.cache/tc39-mcp/ and falling back to bundled editions offline, or over HTTP from a hosted Cloudflare Worker with a limit of 30 requests per 60 seconds per IP. It is read-only, executes nothing and needs no auth. The project states it is independent and not an official Ecma or TC39 publication.

## Features

- **Clause lookup:** Fetch a clause by id, such as sec-tonumber, with algorithm steps as structured data.
- **AOID-aware search:** Exact abstract-operation names rank first in spec search.
- **Cross-references:** Follow references in both directions, including between ECMA-262 and ECMA-402.
- **Edition diffs and history:** Compare editions back to ES2016 or read the upstream git log.
- **test262 and proposals:** Search test262 and look up TC39 proposals.
- **Offline fallback:** Bundled latest editions keep answering when the network is unreachable.

## Good for

- Check the exact steps of an abstract operation while writing a polyfill
- Find which ECMA-262 operations call into Intl
- See what changed in a clause between two editions
- Cite a clause pinned to a specific commit

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tc39-mcp https://mcp.xyzzylabs.ai/tc39/mcp
```

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

```sh
https://mcp.xyzzylabs.ai/tc39/mcp
```

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

```json
{
  "mcpServers": {
    "tc39-mcp": {
      "url": "https://mcp.xyzzylabs.ai/tc39/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "tc39-mcp": {
      "type": "http",
      "url": "https://mcp.xyzzylabs.ai/tc39/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tc39-mcp": {
      "serverUrl": "https://mcp.xyzzylabs.ai/tc39/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tc39-mcp": {
      "type": "http",
      "url": "https://mcp.xyzzylabs.ai/tc39/mcp"
    }
  }
}
```

## Tools

- `clause.get`: Returns one spec clause as structured JSON.
- `clause.list`: Lists clauses.
- `clause.outline`: Returns a clause outline.
- `spec.search`: Searches the spec, ranking abstract-operation identifiers first.
- `spec.crossrefs`: Cross-references in and out, optionally across specs.
- `spec.diff`: Diffs between editions.
- `spec.history`: Walks the upstream git log.
- `test262.search`: Searches the test262 index.
- `proposal.list`: Lists TC39 proposals.
- `proposal.get`: Reads one proposal.

## FAQ

### Which specs and editions are covered?

ECMA-262 and ECMA-402, from es2016 through es2026 plus main.

### Can it run offline?

Yes in part. The npm package bundles the latest stable and main editions and the proposals and test262 indexes.

### Is there a hosted version?

Yes, a Cloudflare Worker at mcp.xyzzylabs.ai/tc39/mcp, rate limited to 30 requests per 60 seconds per IP.

### Does it change anything or run JavaScript?

No. It is read-only and evaluates nothing.

### Is tc39-mcp free?

Yes. tc39-mcp is open source, so you can use and self-host it for free.

### How do I add tc39-mcp to Claude Code?

Run this command in your terminal: claude mcp add --transport http tc39-mcp https://mcp.xyzzylabs.ai/tc39/mcp

### What are the best alternatives to tc39-mcp?

The closest alternatives to tc39-mcp 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/tc39-mcp
