Implementation:Helicone Helicone MCP Package

Knowledge Sources	Helicone
Domains	MCP, Package Management, CLI
Last Updated	2026-02-14 06:32 GMT

Overview

The npm package manifest for @helicone/mcp, the publicly distributed Model Context Protocol server for the Helicone observability platform.

Description

This package.json defines the @helicone/mcp package (version 0.1.6), published as an ESM module under the Apache-2.0 license. It provides a CLI binary (helicone-mcp) that points to the compiled build/index.js entrypoint. The package exposes scripts for building (TypeScript compilation), development (via tsx), formatting and linting (via Biome), type checking, and a two-stage type generation pipeline that first flattens OpenAPI types and then converts them to Zod schemas using ts-to-zod.

The runtime dependencies are @modelcontextprotocol/sdk for MCP protocol support and zod for runtime schema validation. Development tooling includes Biome for formatting/linting, tsx for development execution, and TypeScript 5.9.3 for compilation.

Usage

Install this package to enable AI assistants (such as Claude) to query Helicone observability data and route LLM requests through the Helicone AI Gateway via the Model Context Protocol.

Code Reference

Source Location

• Repository: Helicone
• File: helicone-mcp/package.json

Signature

// Package identity
name: "@helicone/mcp"
version: "0.1.6"
type: "module"

// CLI binary
bin: { "helicone-mcp": "./build/index.js" }

// Key scripts
scripts: {
  build: "tsc && chmod 755 build/index.js",
  dev: "tsx src/index.ts",
  flatten-types: "tsx flatten-types.ts",
  "generate-zod": "npm run flatten-types && ts-to-zod src/types/flat.ts src/types/generated-zod.ts && npm run build"
}

Import

# Install as a dependency
npm install @helicone/mcp

# Or run the CLI directly
npx @helicone/mcp

I/O Contract

Property	Value	Description
name	@helicone/mcp	Scoped npm package name
version	0.1.6	Current published version
type	module	ESM module format
license	Apache-2.0	Open source license
main	./build/index.js	Main entry point
types	./build/index.d.ts	TypeScript declaration entry point

Dependency	Version	Purpose
@modelcontextprotocol/sdk	^1.20.2	MCP protocol implementation
zod	^3.25.76	Runtime schema validation

Dev Dependency	Version	Purpose
@biomejs/biome	^2.2.5	Code formatting and linting
@types/node	^24.9.2	Node.js type definitions
typescript	5.9.3	TypeScript compiler
tsx	^4.7.0	TypeScript execution for development

Usage Examples

# Build the MCP server
cd helicone-mcp
npm run build

# Start development mode
npm run dev

# Generate Zod schemas from OpenAPI types
npm run generate-zod

# Run the CLI binary
npx helicone-mcp

Related Pages

• Principle:Helicone_Helicone_MCP_Type_Generation