Hive MCP server for AI agents

The Hive MCP Server provides a bridge between AI assistants (like Claude) and the Hive blockchain, enabling AI models to interact with Hive through the Model Context Protocol. It allows fetching account information, retrieving posts, creating content, voting, sending tokens, and handling encrypted messaging.

Installation

Basic Setup

To use the Hive MCP Server, you'll need to install it using npm:

npx @gluneau/hive-mcp-server

Authentication Configuration

To enable authenticated operations (voting, posting, sending tokens), set these environment variables:

export HIVE_USERNAME=your-hive-username
export HIVE_POSTING_KEY=your-hive-posting-private-key  # For content operations
export HIVE_ACTIVE_KEY=your-hive-active-private-key    # For token transfers
export HIVE_MEMO_KEY=your-hive-memo-private-key        # For encrypted messaging

Security Note: Never share your private keys or commit them to version control.

Integration with AI Assistants

Claude Desktop

To use this server with Claude Desktop:

Ensure you have Claude Desktop installed
Open or create the Claude configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Add this server to your configuration:

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "@gluneau/hive-mcp-server"],
      "env": {
        "HIVE_USERNAME": "your-hive-username",
        "HIVE_POSTING_KEY": "your-hive-posting-private-key",
        "HIVE_ACTIVE_KEY": "your-hive-active-private-key",
        "HIVE_MEMO_KEY": "your-hive-memo-private-key"
      }
    }
  }
}

Windsurf and Cursor

The same JSON configuration works for Windsurf (in windsurf_config.json) and for Cursor (in ~/.cursor/mcp.json for version >= 0.47).

For earlier Cursor versions, use this one-line command in the MCP section of Settings:

env HIVE_USERNAME=your-hive-username env HIVE_POSTING_KEY=your-hive-posting-private-key env HIVE_ACTIVE_KEY=your-hive-active-private-key env HIVE_MEMO_KEY=your-hive-memo-private-key npx -y @gluneau/hive-mcp-server

Debugging

To test and debug the server, use the MCP Inspector:

npx @modelcontextprotocol/inspector npx @gluneau/hive-mcp-server

Usage Examples

Once connected to an MCP client, you can ask questions like:

"What are the trending posts in the #photography tag on Hive?"
"Show me the recent posts from username 'alice'"
"What's the account balance and details for 'bob'?"
"Get the transaction history for 'charlie'"
"Can you upvote the post by 'dave' with permlink 'my-awesome-post'?"
"Create a new post on Hive about AI technology"
"Send 1 HIVE to user 'frank' with the memo 'Thanks for your help!'"
"Sign this message with my Hive posting key: 'Verifying my identity'"
"Encrypt this message for user 'alice': 'This is a secret message'"
"Show me my encrypted messages and decrypt them"

Available Tools

Reading Data

get_account_info: Get detailed information about a Hive blockchain account
- Parameters: username (Hive username)
get_post_content: Retrieve a specific post by author and permlink
- Parameters: author (post author), permlink (post identifier)
get_posts_by_tag: Retrieve posts by tag and category
- Parameters: category (trending, hot, created, etc.), tag, limit (1-20)
get_posts_by_user: Fetch posts from a specific user or their feed
- Parameters: category (blog or feed), username, limit (1-20)
get_account_history: Get transaction history for an account
- Parameters: username, limit, optional operation_filter
get_chain_properties: Fetch current Hive blockchain properties and statistics
- Parameters: None
get_vesting_delegations: Get vesting delegations made by an account
- Parameters: username, limit, optional from for pagination

Blockchain Interactions (Require Authentication)

vote_on_post: Vote on Hive content (requires posting key)
- Parameters: author, permlink, weight (-10000 to 10000)
create_post: Create new blog posts (requires posting key)
- Parameters: title, body (Markdown supported), tags, and optional parameters
create_comment: Comment on existing posts (requires posting key)
- Parameters: parent_author, parent_permlink, body, and optional parameters
send_token: Send HIVE or HBD cryptocurrency (requires active key)
- Parameters: to (recipient), amount, currency (HIVE or HBD), optional memo

Cryptography and Encrypted Messaging

sign_message: Sign a message using a Hive private key
- Parameters: message, key_type (posting, active, or memo)
verify_signature: Verify a message signature against a Hive public key
- Parameters: message_hash, signature, public_key
encrypt_message: Encrypt a message for a specific Hive account
- Parameters: message, recipient
decrypt_message: Decrypt an encrypted message
- Parameters: encrypted_message, sender
send_encrypted_message: Send an encrypted message using a token transfer
- Parameters: message, recipient, optional amount
get_encrypted_messages: Retrieve and optionally decrypt messages
- Parameters: username, limit, decrypt (boolean)

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "hive" '{"command":"npx","args":["-y","@gluneau/hive-mcp-server"],"env":{"HIVE_USERNAME":"your-hive-username","HIVE_POSTING_KEY":"your-hive-posting-private-key","HIVE_ACTIVE_KEY":"your-hive-active-private-key","HIVE_MEMO_KEY":"your-hive-memo-private-key"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "hive": {
            "command": "npx",
            "args": [
                "-y",
                "@gluneau/hive-mcp-server"
            ],
            "env": {
                "HIVE_USERNAME": "your-hive-username",
                "HIVE_POSTING_KEY": "your-hive-posting-private-key",
                "HIVE_ACTIVE_KEY": "your-hive-active-private-key",
                "HIVE_MEMO_KEY": "your-hive-memo-private-key"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "hive": {
            "command": "npx",
            "args": [
                "-y",
                "@gluneau/hive-mcp-server"
            ],
            "env": {
                "HIVE_USERNAME": "your-hive-username",
                "HIVE_POSTING_KEY": "your-hive-posting-private-key",
                "HIVE_ACTIVE_KEY": "your-hive-active-private-key",
                "HIVE_MEMO_KEY": "your-hive-memo-private-key"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect