GitX MCP Docs

GitX MCP is a GitHub intelligence layer built for AI coding tools. It exposes a standardized MCP (Model Context Protocol) endpoint and a REST API that let AI agents query repository health, momentum, and risk signals in real time.

Instead of asking an AI to guess whether a repository is maintained, GitX MCP fetches live data from the GitHub API — commit velocity, pull request throughput, issue engagement, contributor breadth — and synthesizes it into a single 0–100 momentum score with a plain-English verdict.

Open your Cursor settings and add GitX MCP to the mcpServers block. If you have deployed GitX MCP to Vercel, use the URL transport. For local development, use the stdio transport with the bundled server script.

{
  "mcpServers": {
    "gitxmcp": {
      "url": "https://your-deployment.vercel.app/api/mcp",
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

Once connected, you can ask Cursor: "Analyze the repo solana-labs/solana" or "Which MCP repos are gaining momentum this week?" and it will invoke the GitX MCP tools automatically.

Add GitX MCP to Claude Desktop's MCP configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on Windows.

{
  "mcpServers": {
    "gitxmcp": {
      "command": "npx",
      "args": ["tsx", "/path/to/gitxmcp/scripts/gitxmcp-server.ts"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

The gitxmcp-server.ts script is included in the scripts/ directory. It implements the same MCP tool logic as the HTTP endpoint, using stdio transport for local use.

Note: Local MCP package publishing via npx gitxmcp is planned. For now, point directly to the script path or use the HTTP endpoint after deploying to Vercel.

Claude Code supports HTTP MCP endpoints directly. Run the following command to register GitX MCP as a project-scoped server:

# In your project directory
claude mcp add gitxmcp \
  --url https://your-deployment.vercel.app/api/mcp \
  --env GITHUB_TOKEN=your_github_token

After adding the server, Claude Code will have access to all four GitX MCP tools. You can verify with /mcp in any Claude Code session.

GitX MCP exposes four tools over the MCP protocol. All tools reuse the same core analysis logic from lib/analysis.ts.

// Tool: analyze_repo
{
  "name": "analyze_repo",
  "description": "Analyze a GitHub repository momentum, status, and risk level.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "owner": { "type": "string" },
      "repo": { "type": "string" }
    },
    "required": ["owner", "repo"]
  }
}

// Tool: find_trending_repos
{
  "name": "find_trending_repos",
  "description": "Find trending GitHub repositories for a topic.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topic": { "type": "string" },
      "timeframe": { "type": "string", "enum": ["7d", "30d"] },
      "limit": { "type": "number" }
    },
    "required": ["topic"]
  }
}

// Tool: compare_repos
{
  "name": "compare_repos",
  "description": "Compare and rank repositories by developer momentum.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "repos": { "type": "array", "items": { "type": "string" } }
    },
    "required": ["repos"]
  }
}

// Tool: repo_health_check
{
  "name": "repo_health_check",
  "description": "Run a health check on a repository via its GitHub URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "repo_url": { "type": "string" }
    },
    "required": ["repo_url"]
  }
}

These prompts work with any AI tool connected to GitX MCP.

• →Which Solana repos are gaining developer momentum this week?
• →Analyze solana-labs/solana and tell me if it's still actively developed.
• →Compare these three repos by developer activity: solana-labs/solana, near/nearcore, aptos-labs/aptos-core
• →Find early alpha AI agent repos that are gaining traction.
• →Is modelcontextprotocol/servers a safe dependency to take on?
• →Show me the top 5 trending TypeScript repos right now.
• →Which devtools repos have had the most commit activity in the last 30 days?
• →Run a health check on https://github.com/vercel/next.js

GitX MCP exposes a REST API via Next.js Route Handlers. All routes are available at your deployment URL.

curl -X POST https://your-deployment.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "owner": "solana-labs",
    "repo": "solana"
  }'

curl -X POST https://your-deployment.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "repo_url": "https://github.com/modelcontextprotocol/servers"
  }'

curl "https://your-deployment.vercel.app/api/trending?topic=mcp&limit=5"

curl -X POST https://your-deployment.vercel.app/api/compare \
  -H "Content-Type: application/json" \
  -d '{
    "repos": [
      "solana-labs/solana",
      "near/nearcore",
      "aptos-labs/aptos-core"
    ]
  }'

{
  "repo": "solana-labs/solana",
  "url": "https://github.com/solana-labs/solana",
  "description": "Web-Scale Blockchain for fast, secure, scalable, decentralized apps and marketplaces.",
  "status": "active",
  "momentum_score": 78,
  "risk_level": "low",
  "summary": "solana-labs/solana (Rust) is an actively developed project...",
  "signals": {
    "stars": 13200,
    "forks": 4100,
    "open_issues": 580,
    "language": "Rust",
    "license": "Apache-2.0",
    "archived": false,
    "recent_commits_7d": 24,
    "recent_commits_30d": 98,
    "recent_prs_30d": 67,
    "recent_issues_30d": 43,
    "contributors_estimate": 100,
    "created_at": "2018-11-11T00:00:00Z",
    "updated_at": "2024-01-15T12:00:00Z",
    "pushed_at": "2024-01-15T10:30:00Z"
  },
  "verdict": "Healthy, actively maintained repository.",
  "warnings": [],
  "analyzed_at": "2024-01-15T12:05:00Z"
}

GitX MCP requires one optional environment variable and works with zero configuration, but rate limits will be much more restricted without a token.

# .env.local
GITHUB_TOKEN=ghp_your_personal_access_token
NEXT_PUBLIC_APP_URL=http://localhost:3000