Skip to main content
Hero Light

​
What is ICP Agent Kit?

ICP Agent Kit is a comprehensive TypeScript library that enables natural language interaction with the Internet Computer Protocol (ICP) blockchain ecosystem. Built with LangChain integration in mind, it provides both direct API methods and natural language processing capabilities for ICP-related operations.

​
Key Features

Natural Language Processing

Chat with the ICP blockchain using natural language commands powered by LangChain and OpenAI.

Complete Plugin Suite

Four core plugins: Identity, Token, Canister, and Cycles management with full API coverage.

10 LangChain Tools

Pre-built tools for all blockchain operations: transfers, deployments, balance checks, and more.

Specialized Agents

Purpose-built agents for DeFi operations, canister development, and general blockchain tasks.

​
Quick Examples

  • Natural Language
  • Direct API
import { ICPAgent } from 'icp-agent-kit';

// Initialize with OpenAI for natural language
const agent = new ICPAgent({ 
  network: 'mainnet',
  openai: { apiKey: process.env.OPENAI_API_KEY }
});
await agent.initialize();

// Use natural language commands
await agent.processNaturalLanguage('Check my ICP balance');
await agent.processNaturalLanguage('Transfer 5 ICP to alice.icp');
await agent.processNaturalLanguage('Create a new canister with 2T cycles');

// Or use specialized agents
const defiAgent = agent.createAgent('defi');
await defiAgent.chat('Show me all my token balances');

​
Features

Production Ready: Comprehensive TypeScript library for ICP blockchain interaction🔧 Core Plugins:
  • Identity: Seed phrases, anonymous identities, switching, and management
  • Token: ICP transfers, ICRC-1/2 support, balance queries, metadata
  • Canister: Create, deploy, upgrade, call methods, manage controllers
  • Cycles: Monitor, top-up, convert ICP, forecasting, auto-management
🤖 AI Integration:
  • 10 pre-built LangChain tools covering all operations
  • Natural language processing via OpenAI GPT-4
  • 4 specialized agent templates (DeFi, Developer, General, Governance)
  • Context-aware conversations with session management
📚 Examples & Resources:
  • Production-ready sample applications
  • Comprehensive TypeScript documentation
  • Real-world usage patterns and best practices
  • Complete test coverage and reliability

​
Key Capabilities

1

🔐 Identity Management

Complete identity system with seed phrases, anonymous identities, and secure switching.
2

💰 Token Operations

Full ICP and ICRC-1/2 token support with transfers, balance queries, and metadata.
3

🚀 Canister Management

Deploy, upgrade, and interact with canisters using both direct API and natural language.
4

⚡ Cycles Management

Monitor, top-up, and automate cycles management with forecasting and alerts.
5

🤖 AI Integration

Natural language processing with specialized agents for different blockchain tasks.

​
Why ICP Agent Kit?

Chat with the blockchain! Ask questions and execute commands in plain English, powered by OpenAI and LangChain.
Everything you need: identity management, token operations, canister deployment, and cycles management in one package.
Comprehensive test coverage, robust error handling, security best practices, and proven reliability.
Choose your style: natural language commands or direct TypeScript APIs. Full type safety and IntelliSense support.
Purpose-built agents for different tasks: DeFi operations, canister development, or general blockchain interactions.

​
Get Started

Ready to start building with ICP Agent Kit? Follow our quickstart guide to set up your first project in minutes.

View on GitHub

Explore the source code, contribute, or report issues on GitHub.
⌘I