Skip to content
MCP server

YC GraphQL MCP · Distributed Systems

Read and edit your Y Combinator application from an MCP client, with verified saves

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
2.1.0
Listing updated
2 days ago

About YC GraphQL MCP · Distributed Systems

YC GraphQL MCP · Distributed Systems is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

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

{
  "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 this server provides (22)

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

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.

What it does

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

Pricing

Open source

MIT licensed

YC GraphQL MCP · Distributed Systems 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 to YC GraphQL MCP · Distributed Systems

  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. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity