Skip to main content

What is HAIP?

The Human-Agent Interaction Protocol (HAIP) is an open standard designed to streamline real-time, multi-modal exchanges between user-facing web, mobile, and voice applications and AI agents. It complements the Model Context Protocol (MCP): HAIP focuses on the human-agent layer, acting as a universal translator between frontend interfaces and intelligent backends, while MCP governs tool execution.

Features

  • Re-establishing dropped connections & ensuring message order.
  • Multimodal transactions audio and text.
  • Allowing multiple users and LLMs to share a conversation (transaction).
  • Letting the user know about MCP (Model Context Protocol) calls.
  • Transaction history, transaction management, schema validation, custom tooling, logging, authentication and more.

Available Packages

@haip/sdk

npm
version
TypeScript SDK for HAIP

@haip/server

npm
version
Reference HAIP server

@haip/cli

npm
version
Command-line interface

Get Started

Follow our quickstart guide to implement HAIP in your application.

HAIP CLI

Use the command-line interface for testing and monitoring HAIP servers.

Key Features

Multi-modal Interaction

Native support for text chat and audio streams with seamless switching.

Asynchronous Tools

Non-blocking agent workflows with real-time progress updates.

Robust Streaming

Low-latency chunk delivery with reconnection and de-duplication.

Transport Agnostic

Works over WebSockets, SSE, HTTP streaming, or any message bus.

Quick Implementation

WebSocket Connection

Establish bidirectional streaming communication with WebSockets.

Server-Sent Events

Use SSE for one-way streaming from server to client.

Authentication

Secure your connections with JWT Bearer tokens.

Flow Control

Manage back-pressure and prevent overwhelming your system.

Protocol Features

Event Sequencing

Tolerant of out-of-order or overlapping events with automatic replay.

Tool Integration

Dynamic advertisement of tools and schemas with seamless invocation.

Framework Agnostic

Works with React, Vue, Angular, native mobile or any framework.

MCP Compatibility

Seamless integration with Model Context Protocol for tool execution.

Ready to build?

View API Reference

Explore the complete HAIP API specification and event schemas.