# YC GraphQL MCP · Distributed Systems

> YC GraphQL MCP · Distributed Systems is an open-source MCP server for developer tools. Read and edit your Y Combinator application from an MCP client, with verified saves. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/arthurcolle/yc-graphql-mcp
- **MCP Registry name:** io.github.arthurcolle/yc-graphql-mcp
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-15

## About

This is an unofficial local client for the GraphQL endpoint behind apply.ycombinator.com, so an assistant can read your application answers, spot unclear or contradictory claims and compare them with a draft. YC owns the upstream API, login rules and edit permissions, and the README says to stop on authentication or access restrictions rather than bypass them.

Edits follow a prepare, commit and verify flow. Preparing shows exact before-and-after values and sends nothing. Committing rechecks current answers, submission state and live field permissions, writes once, then reads back to confirm what persisted. Concurrent edits stop the write, durable receipts record mutations, and financial answers are protected unless explicitly allowed.

Setup is from source with Node 22.13 or later: you sign in once in a Chromium window, and only the required session headers are saved to a private file, never your password or a full browser profile. Answers returned by tools are visible to your MCP host and model, and GraphQL data is marked untrusted. The project is MIT licensed at version 2.1.0 with 22 tools.

## Features

- **Application reads:** List applications and fetch answers, status and founder profiles.
- **Prepare then commit:** Preview diffs before a single guarded write.
- **Save verification:** Read back fields and compare with the receipt.
- **Private session capture:** Sign in once; only needed headers are stored locally.
- **Operation registry:** Save and run observed GraphQL operations.
- **Markdown export:** Private export returned to the host, no files written.

## Good for

- Review application answers for contradictions
- Compare current answers with a new draft
- Confirm what actually saved after an edit
- Export an application as Markdown

## Install

### Claude Code (Terminal)

```sh
claude mcp add yc-graphql-mcp -- npx -y https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "yc-graphql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yc-graphql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "yc-graphql-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yc-graphql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yc-graphql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `yc_get_editability`: Live form fields and current application permissions.
- `yc_prepare_application_update`: Typed text changes with exact diffs and preconditions.
- `yc_commit_application_update`: Rechecks, commits once and verifies saved answers.
- `yc_verify_application_update`: Compares current answers with expected values without writing.
- `yc_export_application`: Returns private Markdown to the host; writes no files.
- `yc_status`: Local auth state, transport and mutation policy.
- `yc_connection`: Setup information and extension pairing.
- `yc_list_applications`: Application summaries and edit flags.
- `yc_get_application`: Answers and status for an application UUID.
- `yc_get_founder_profile`: Founder narrative, education and work history.
- `yc_describe_schema`: GraphQL root types, if introspection is allowed.
- `yc_describe_type`: Fields, inputs and enums of a type.
- `yc_introspect_schema`: Full schema, capped at 2 MB.
- `yc_inspect_scripts`: Search referenced JavaScript without executing it.
- `yc_query`: Execute one explicitly named query.
- `yc_register_operation`: Save an observed document locally.
- `yc_list_operations`: List saved documents.
- `yc_remove_operation`: Remove a saved document.
- `yc_run_operation`: Run a saved query with variables.
- `yc_prepare_mutation`: Inert preview of an exact payload with a receipt.
- `yc_commit_mutation`: Commit a reviewed preview once.
- `yc_mutation_receipts`: Inspect durable receipts.

## FAQ

### Is it official?

No. The README calls it an unofficial client; YC controls the API and permissions.

### Are my credentials stored?

No password is captured; session headers go in a 0600 private file.

### Can it change financial answers?

Only if allowFinancialChanges is explicitly set.

### What is required to run it?

Node.js 22.13 or later and a Chromium sign-in via Playwright.

### Is YC GraphQL MCP · Distributed Systems free?

Yes. YC GraphQL MCP · Distributed Systems is open source, so you can use and self-host it for free.

### How do I add YC GraphQL MCP · Distributed Systems to Claude Code?

Run this command in your terminal: claude mcp add yc-graphql-mcp -- npx -y https://github.com/arthurcolle/yc-graphql-mcp/releases/download/v2.1.0/yc-graphql-mcp-2.1.0.mcpb

### What are the best alternatives to YC GraphQL MCP · Distributed Systems?

The closest alternatives to YC GraphQL MCP · Distributed Systems 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

---
Source: https://ai-powered.com/mcp/yc-graphql-mcp-distributed-systems
