tc39-mcp
Structured, SHA-pinned lookup of the ECMAScript and Intl specs for AI agents
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.xyzzylabs.ai/tc39/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tc39-mcp": {
"url": "https://mcp.xyzzylabs.ai/tc39/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools