MCPify

Compile software into AI-operable systems.

MCPify is the AI Enablement Compiler. Transform applications, APIs, frontends, workflows, and databases into AI-native systems for autonomous agents.

Overview · Features · Getting Started · CLI · Architecture

Overview

Problem Statement

Modern software is built for humans, not agents. The useful actions are scattered across frontend interactions, backend services, APIs, databases, and workflows, which forces AI systems into brittle browser automation or hand-written MCP boilerplate.

• manual MCP tool authoring for capabilities that already exist
• brittle browser automation for UI interactions
• raw endpoints instead of meaningful workflows
• permission and safety gaps at the tool boundary
• schema and tool drift as the application changes

Solution

MCPify acts as a compiler for your application. It scans the parts of the codebase that matter to agents and produces a runnable MCP server, semantic workflows, permission-aware tools, and the metadata an agent needs to use them safely.

Stop hand-writing MCP tools. Compile your stack once. Stay in sync forever.

Codex Usage

Codex is a natural fit for MCPify in a few ways:

1. Ideate - use Codex to explore agent workflows, sketch MCP surfaces, and refine how a product should be exposed to AI.
2. Build - use Codex to implement or extend the compiler, generators, analyzers, and demo apps in this repo.
3. Run as MCP inside Codex - connect the generated MCP server so Codex can call real tools, inspect app surfaces, and operate against the compiled environment.

Features

• Backend Analyzer: Deep AST analysis of routes, controllers, and services to surface every callable action.
• Frontend Action Extraction: React, Vue, Svelte components mapped to agent-controllable actions.
• OpenAPI → MCP: Drop in a spec, ship a typed MCP server in seconds.
• Workflow Engine: Multi-step processes detected and exposed as atomic agent capabilities.
• Permission Layer: Scopes, roles, and audit trails enforced at the tool boundary.
• AI Metadata Enhancement: Auto-generated descriptions, hints, and examples agents actually understand.
• Database Intelligence: Schemas, relations, and constraints become safe, queryable surfaces.
• Event System Integration: Webhooks, queues, and pub/sub plugged into agent loops.
• Knowledge Graph Engine: Entities, intents, and relations modeled across your stack.
• Self-Updating Sync: MCP definitions regenerate on every commit. No drift.
• AI Simulations: Run agents against your app in a sandbox before shipping.

Getting Started

This repository is a monorepo containing the MCPify compiler and its supporting packages. The easiest way to try MCPify is from source:

npm install
npm run build

Run the CLI against the flagship ecommerce example:

npm run mcpify -- analyze ./examples/ecommerce-saas \
  --output ./examples/ecommerce-saas/.mcpify \
  --prisma ./examples/ecommerce-saas/prisma/schema.prisma \
  --swagger ./examples/ecommerce-saas/openapi.json

After generation:

cd examples/ecommerce-saas/.mcpify
npm install
npm run build

The generated AGENTS.md explains how to connect the compiled server to an MCP client. The ecommerce walkthrough lives in examples/ecommerce-saas/DEMO.md.

CLI

analyze [path]

Default command. Runs the full pipeline:

• backend analysis
• optional OpenAPI, Prisma, Drizzle, and Mongoose analysis
• event and webhook discovery
• optional frontend extraction
• workflow detection
• permission classification
• MCP server generation

npm run mcpify -- analyze . \
  --swagger ./tests/fixtures/swagger/petstore.yaml \
  --prisma ./tests/fixtures/prisma/simple.prisma \
  --watch

Useful flags:

• --output <dir> change output directory
• --no-frontend skip UI action extraction
• --no-events skip webhook and listener analysis
• --no-workflows skip workflow detection
• --ai-enhance improve tool descriptions (requires ANTHROPIC_API_KEY)

interactive

Prompts for which analyzers to run and which source files to include.

npm run mcpify -- interactive

frontend [path]

Extracts UI actions only and can print raw JSON.

npm run mcpify -- frontend ./examples/internal-tool --json

swagger <file>

Converts an OpenAPI or Swagger spec directly into MCP tools.

npm run mcpify -- swagger ./tests/fixtures/swagger/petstore.yaml

audit [path] & simulate [path]

Run a static safety audit over the discovered tools and workflows. When ANTHROPIC_API_KEY is available, simulate executes an AI simulation battery against the discovered tool surface.

npm run mcpify -- simulate ./examples/express-api

Architecture

Built for the way agents actually operate. A layered system that keeps your application untouched while exposing exactly what agents need:

1. AI Agents: Any agent runtime (Claude, GPT, Custom) connects over MCP to start operating your software like a power user.
2. MCP Layer: Generated tools, resources, and prompts that map 1:1 to real surface in your app. The contract agents speak.
3. Permissions: Every call passes through scopes, audit logs, and rate limits before it touches your system.
4. Workflows: Discovered user journeys exposed as composable, stateful operations agents can chain.
5. Your App: Your existing stack (Frontend, Backend, Database, APIs) — untouched. MCPify reads it; it never rewrites it.

Repository Structure

mcpify/
  apps/
  docs/
  examples/
  landingPage/
  packages/
    ai-enhancer/
    backend-analyzer/
    cli/
    event-analyzer/
    frontend-analyzer/
    graph-engine/
    mcp-generator/
    monitoring/
    permissions/
    schema-engine/
    security/
    sync-engine/
    workflow-engine/
  tests/

License

See LICENSE.