Skip to main content

​
Overview

The Hedera Agent Kit provides a comprehensive set of tools organized into plugins, which can be installed alongside the Hedera Agent Kit and used to extend the core functionality of the Hedera Agent Kit SDK. These tools can be used both by the conversational agent and when you are building with the SDK. The Hedera services built into this agent toolkit are also implemented as plugins. You can see a description of each plugin in the HEDERAPLUGINS.md file, as well as a list of the individual tools for each Hedera service that are included in each plugin.

​
Contribute

Developers can contribute new plugins to the Hedera Agent Kit by following the guidelines in the plugin docs for each SDK:

​
Hedera Plugins & Architecture

All tools in the Hedera Agent Kit, including tools available to use Hedera native services and EVM features, are organized into groups as plugins, each containing a set functionality related to the Hedera service or project they are created for. The SDKs also provide an extensive plugin system that allows developers to create their own third-party plugins for use with the Hedera Agent Kit.

​
Hedera Plugins

Available plugins built into the Hedera Agent Kit include:
  • Core Account Plugin: Tools for Hedera Account Service operations
  • Core Account Query Plugin: Tools for querying Hedera Account Service related data
  • Core Consensus Plugin: Tools for Hedera Consensus Service (HCS) operations
  • Core Consensus Query Plugin: Tools for querying Hedera Consensus Service (HCS) related data
  • Core Token Plugin: Tools for Hedera Token Service (HTS) operations
  • Core Token Query Plugin: Tools for querying Hedera Token Service related data
  • Core EVM Plugin: Tools for interacting with EVM smart contracts on Hedera (ERC-20 and ERC-721)
  • Core EVM Query Plugin: Tools for querying smart contract-related data on Hedera
  • Core Misc Query Plugin: Tools for fetching miscellaneous information from Hedera Mirror Node
  • Core Transaction Query Plugin: Tools for handling Hedera transaction–related queries
See the full documentation to understand how to use them with parameters and examples can be found in the docs/HEDERAPLUGINS.md file in the JavaScript SDK and the Python SDK.

​
Available Third Party Plugins

The Hedera Agent Kit is extensible with third party plugins created by third parties projects.

​
Using Plugins

​
JavaScript / TypeScript

Starting with v4, the Hedera Agent Kit is published under the @hashgraph scope and plugins are imported from the @hashgraph/hedera-agent-kit/plugins subpath. Framework integrations (LangChain, Vercel AI SDK, ElizaOS, MCP) are now separate packages. Which packages do I need?
PackagePurpose
@hashgraph/hedera-agent-kitCore types, AgentMode, Plugin, Tool, HederaBuilder
@hashgraph/hedera-agent-kit/pluginsAll built-in Hedera plugins (subpath of core)
@hashgraph/hedera-agent-kit-langchainLangChain toolkit (HederaLangchainToolkit)
@hashgraph/hedera-agent-kit-ai-sdkVercel AI SDK toolkit (HederaAIToolkit)
@hashgraph/hedera-agent-kit-elizaosElizaOS toolkit (HederaElizaOSToolkit)
@hashgraph/hedera-agent-kit-mcpMCP toolkit (HederaMCPToolkit)
Install the core package plus your chosen framework toolkit and LLM provider: LangChain + OpenAI 
npm install @hiero-ledger/sdk @hashgraph/hedera-agent-kit @hashgraph/hedera-agent-kit-langchain @langchain/openai dotenv
LangChain + Anthropic 
npm install @hiero-ledger/sdk @hashgraph/hedera-agent-kit @hashgraph/hedera-agent-kit-langchain @langchain/anthropic dotenv
Vercel AI SDK + OpenAI 
npm install @hiero-ledger/sdk @hashgraph/hedera-agent-kit @hashgraph/hedera-agent-kit-ai-sdk @ai-sdk/openai dotenv
Import plugins from the /plugins subpath and pass them explicitly in the toolkit configuration. Use allCorePlugins to load every built-in plugin at once, or list individual plugins to narrow the tool surface: 
import { Client, PrivateKey } from '@hiero-ledger/sdk';
import { AgentMode } from '@hashgraph/hedera-agent-kit';
import { allCorePlugins } from '@hashgraph/hedera-agent-kit/plugins';
import { HederaLangchainToolkit } from '@hashgraph/hedera-agent-kit-langchain';

const client = Client.forTestnet().setOperator(
  process.env.ACCOUNT_ID!,
  PrivateKey.fromStringECDSA(process.env.PRIVATE_KEY!),
);

const toolkit = new HederaLangchainToolkit({
  client,
  configuration: {
    plugins: allCorePlugins,
    context: { mode: AgentMode.AUTONOMOUS },
  },
});

const tools = toolkit.getTools();
If you only want a subset of the tools, import individual plugins instead of allCorePlugins: 
import {
  coreAccountPlugin,
  coreAccountQueryPlugin,
  coreTokenPlugin,
  coreConsensusPlugin,
} from '@hashgraph/hedera-agent-kit/plugins';

const toolkit = new HederaLangchainToolkit({
  client,
  configuration: {
    plugins: [coreAccountPlugin, coreAccountQueryPlugin, coreTokenPlugin, coreConsensusPlugin],
    context: { mode: AgentMode.AUTONOMOUS },
  },
});
Important: Plugins must be explicitly opted in. Passing an empty plugins array will result in an agent with no tools available. Use allCorePlugins if you want the full tool surface without listing every plugin by hand.

​
Python

In the Python SDK, plugins are imported from hedera_agent_kit.plugins: 
from hedera_agent_kit.langchain.toolkit import HederaLangchainToolkit
from hedera_agent_kit.plugins import (
    core_account_plugin,
    core_account_query_plugin,
    core_token_plugin,
    core_consensus_plugin,
)
from hedera_agent_kit.shared.configuration import Configuration, Context, AgentMode

configuration = Configuration(
    plugins=[
        core_account_plugin,
        core_account_query_plugin,
        core_token_plugin,
        core_consensus_plugin,
    ],
    context=Context(
        mode=AgentMode.AUTONOMOUS,
        account_id=str(account_id),
    ),
)

hedera_toolkit = HederaLangchainToolkit(client=client, configuration=configuration)
tools = hedera_toolkit.get_tools()