Mcp Poi
About
MCP server that prepares Proof of Invention (POI) transaction requests for submission
Details
- Author
- elmariachi111
- Downloads
- 287
- Categories
- Other
Jump to
- Processes binary files and prepares blockchain transaction data.
- Generates a Merkle root hash representing the Proof of Invention.
- Outputs a formatted transaction request (to, data, value).
- Integrates with the PoI API via bearer token authentication.
- Works with Claude Desktop, Cursor, and other MCP clients.
- Can be combined with wallet and filesystem MCP servers.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp PoiCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with npm install, and build the server with npm run build. Set the API_TOKEN environment variable with a bearer token obtained from Molecule’s Discord. Add the server to your MCP client (e.g., Claude Desktop) using the npx mcp-poi command with the token. The server exposes the tool create_proof_of_invention_request, which accepts a file path and returns a transaction request object containing the recipient address, Merkle root hash, and value.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp poi": {
"poi": {
"command": "npx",
"args": [
"-y",
"mcp-poi"
],
"env": {
"API_TOKEN": ""
}
}
}
}
}McpServers
{
"poi": {
"command": "npx",
"args": [
"-y",
"mcp-poi"
],
"env": {
"API_TOKEN": ""
}
}
}MCP POI Server
A Model Context Protocol server for processing files and preparing blockchain transactions. This server can be installed in Claude Desktop and provides a tool to process files and prepare them for blockchain transactions.
https://github.com/user-attachments/assets/6b2fbd68-4eca-4130-9594-d6720508e9c8
Setup
1. Clone this repository
2. Install dependencies:
npm install
3. Build the server:
npm run build
Environment Variables
- API_TOKEN: Your API bearer token for authentication against the PoI API. You can request a new token on Molecule's Discord Server: https://discord.gg/k4ER7vZcj8
Usage
The server provides a tool called create_proof_of_invention_request that accepts a file path returns prepared transaction data suitable for blockchain execution. This can be reused by your favorite tool that can sign and submit transactions. The binary content should be provided by the MCP client (e.g., Claude Desktop or Cursor).
https://docs.molecule.to/documentation/proof-of-invention-poi/api-access-beta
Adding to Claude Desktop
"poi": {
"command": "npx",
"args": ["mcp-poi"],
"env": {
"API_TOKEN": "the api token"
}
}
Plays nicely with other MCP servers
- https://pypi.org/project/mcp-server-fetch/
- https://www.npmjs.com/package/@mcp-dockmaster/mcp-cryptowallet-evm
Our complete Claude desktop config looks:
{
"mcpServers": {
"mcp-cryptowallet-evm": {
"command": "npx",
"args": ["@mcp-dockmaster/mcp-cryptowallet-evm"],
"env": {
"PRIVATE_KEY": ""
}
},
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/stadolf/Downloads",
"/Users/stadolf/Documents"
]
},
"poi": {
"command": "npx",
"args": ["-y", "mcp-poi"],
"env": {
"API_TOKEN": ""
}
}
}
}
Prompts
| Create a poi hash from the "idea.md" file in my Documents folder
...
| send and Eth transation with the poi hash to the poi's to address on the base blockchain
Tool Schema
Input:
{
filepath: string; // A path of a binary
}
Output:
{
transaction_request: {
to: string, // a PoI anchoring address (usually starts with 0x1dea)
data: string, // the merkle root hash that represents the PoI
value: string, // 0
}
}
Running the Server
npm start
Development
For development with automatic rebuilding:
npm run dev
Error Handling
The server includes robust error handling for:
- Missing environment variables
- Invalid file content
- API communication errors
- Invalid response formats
Security
- API tokens are loaded from environment variables
- File contents are properly encoded before transmission
- Error messages are sanitized to prevent information leakage
- No filesystem access required - all content is provided by the MCP client
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
