Getting Started

Prerequisites

• Node ≥ 22.18 (Bridgent uses native --experimental-strip-types to run TS without a build step)
• pnpm ≥ 10

1. Install

pnpm add -D @bridgent/cli @bridgent/core zod

2. Create your first server

Use the starter generator:

bridgent init ./server.ts

Or create server.ts manually:

import { createStdioServer, defineTool } from '@bridgent/core'
import { z } from 'zod'

await createStdioServer({
  name: 'hello',
  version: '0.0.1',
  tools: [
    defineTool({
      name: 'add',
      description: 'Add two numbers',
      inputSchema: z.object({
        a: z.number(),
        b: z.number(),
      }),
      run: ({ a, b }) => ({ sum: a + b }),
    }),
  ],
})

3. Run it

bridgent dev ./server.ts

That's it — your file is now an MCP server speaking stdio.

4. Try it from Claude Code

Add this to ~/.claude.json (or your IDE-agent config):

{
  "mcpServers": {
    "hello": {
      "command": "bridgent",
      "args": ["dev", "./server.ts"]
    }
  }
}

Restart Claude Code, and you'll see add show up in the tool picker.

5. Verify with the official inspector

pnpm dlx @modelcontextprotocol/inspector bridgent dev ./server.ts

The inspector lets you list tools, send tools/call, and inspect results without an LLM in the loop.

Next steps

• Browse examples
• Try shipped source adapters: OpenAPI, Prisma, Drizzle, or Zod
• Roadmap: tRPC in v0.3, then source metadata, improved inspector hints, and GraphQL after a concrete integration target appears