keryx

Overview

Keryx is a modern fullstack TypeScript framework built on Bun that unifies API development across multiple transport layers. It transforms a single action class into HTTP endpoints, WebSocket handlers, CLI commands, background tasks, and MCP tools with no code duplication. Every action supports OAuth 2.1 authentication for MCP clients and maintains consistent validation through Zod schemas across all transport methods.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• user:create

  Create a new user

  Try:Create a new user with name John, email john@example.com, and password secret123Try:Add a new user to the system
• user-get

  Get user information by ID

  Try:Get details for user with ID 123Try:Find user information by user ID

Comparable tools

Installation

# Create a new project
bunx keryx new my-app
cd my-app
cp .env.example .env
bun install
bun dev

{
  "mcpServers": {
    "my-app": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

FAQ

How does Keryx handle MCP authentication?

Keryx uses OAuth 2.1 with PKCE for MCP authentication. Clients go through a browser-based login flow, and subsequent tool calls carry a Bearer token tied to the authenticated user's session.

Can I selectively expose actions as MCP tools?

Yes. By default, all actions are exposed as MCP tools. You can exclude specific actions with `mcp = { tool: false }` or expose them as MCP resources or prompts instead.

Compare keryx with