GitHub-to-MCP x402 Integration

Convert any GitHub repo to MCP server - automatic tool generation, API wrap.

Overview

Repository: nirholas/github-to-mcp
MCP Registry: io.github.nirholas/github-to-mcp
x402 Use Case: Premium conversions, private repos, enterprise features

Installation

npm install @nirholas/x402-ecosystem @nirholas/github-to-mcp

Integration Pattern

import { PaywallBuilder, PricingStrategy } from '@nirholas/x402-ecosystem/premium';
import { GitHubToMCP } from '@nirholas/github-to-mcp';

// Repo complexity pricing
const conversionPricing = PricingStrategy.tiered([
  { threshold: 10, priceUsd: 0 },       // Free: < 10 files
  { threshold: 50, priceUsd: 0.10 },    // $0.10: 10-50 files
  { threshold: 200, priceUsd: 0.50 },   // $0.50: 50-200 files
  { threshold: 1000, priceUsd: 2.00 },  // $2.00: 200-1000 files
  { threshold: Infinity, priceUsd: 10 } // $10: monorepos
]);

const converter = new PaywallBuilder()
  .service('github-to-mcp')
  .pricing(conversionPricing)
  .feature('private-repo', 0.25)     // +$0.25 for private repos
  .feature('auto-docs', 0.15)        // +$0.15 for documentation
  .feature('type-inference', 0.20)   // +$0.20 for TypeScript types
  .feature('test-generation', 0.50)  // +$0.50 for test scaffolds
  .build();

Conversion Service

// Convert GitHub repo to MCP server
async function convertRepo(repoUrl: string, options: ConvertOptions = {}) {
  const analysis = await GitHubToMCP.analyze(repoUrl);

  // Calculate base cost
  let cost = conversionPricing.calculate({ usage: analysis.fileCount });

  // Add feature costs
  if (analysis.isPrivate) cost += 0.25;
  if (options.generateDocs) cost += 0.15;
  if (options.inferTypes) cost += 0.20;
  if (options.generateTests) cost += 0.50;

  if (cost > 0) {
    await converter.charge(cost, { repo: repoUrl, analysis, options });
  }

  return GitHubToMCP.convert(repoUrl, options);
}

Analysis Output

interface RepoAnalysis {
  fileCount: number;
  languages: string[];
  hasApi: boolean;
  hasCli: boolean;
  endpoints: EndpointInfo[];
  functions: FunctionInfo[];
  suggestedTools: ToolSuggestion[];
  complexity: 'simple' | 'medium' | 'complex' | 'monorepo';
  estimatedCost: number;
}

Premium Features

Feature	Free	Premium
Public repos (<10 files)	✅	✅
Basic tool extraction	✅	✅
Private repos	❌	+$0.25
Auto documentation	❌	+$0.15
TypeScript inference	❌	+$0.20
Test generation	❌	+$0.50
Monorepo support	❌	$10+
CI/CD integration	❌	+$1.00

Batch Conversion

import { PayableAgent } from '@nirholas/x402-ecosystem/agent';

const agent = new PayableAgent({
  wallet: agentWallet,
  approvedServices: ['github-to-mcp'],
  dailyLimit: 50
});

// Convert multiple repos
async function batchConvert(repos: string[]) {
  const analyses = await Promise.all(
    repos.map(r => GitHubToMCP.analyze(r))
  );

  const totalCost = analyses.reduce((sum, a) => 
    sum + conversionPricing.calculate({ usage: a.fileCount }), 0
  );

  // 25% batch discount
  const discountedCost = totalCost * 0.75;

  await agent.pay({
    service: 'github-to-mcp',
    amount: discountedCost,
    description: `Batch convert ${repos.length} repos`
  });

  return GitHubToMCP.batchConvert(repos);
}

Output Templates

// Generated MCP server structure
const outputTemplate = {
  'package.json': '// Dependencies and scripts',
  'src/index.ts': '// MCP server entry point',
  'src/tools.ts': '// Generated tool definitions',
  'src/handlers.ts': '// Tool implementation handlers',
  'README.md': '// Auto-generated documentation',
  'tsconfig.json': '// TypeScript configuration'
};

Revenue Model

const revenueSplit = {
  developer: 0.70,      // GitHub-to-MCP maintainer
  ecosystem: 0.20,      // Universal Crypto MCP
  infrastructure: 0.10  // x402 + GitHub API
};

MCP Tool Registration

server.tool('convert_github_to_mcp', {
  description: 'Convert GitHub repository to MCP server',
  inputSchema: z.object({
    repoUrl: z.string().url(),
    generateDocs: z.boolean().default(true),
    inferTypes: z.boolean().default(true),
    generateTests: z.boolean().default(false)
  }),
  handler: async (params) => {
    return convertRepo(params.repoUrl, params);
  }
});