Skip to content
MCP server

tc39-mcp

Structured, SHA-pinned lookup of the ECMAScript and Intl specs for AI agents

Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally or Remotely
Version
0.6.6
Listing updated
3 days ago

About tc39-mcp

tc39-mcp is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.xyzzylabs.ai/tc39/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tc39-mcp": {
      "url": "https://mcp.xyzzylabs.ai/tc39/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; hosted endpoint is free

Prices change. Check mcp.xyzzylabs.ai before you buy.

tc39-mcp 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 to tc39-mcp

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools