aipou-mcp-server
v0.2.2
Published
MCP server for private, signed AI task receipts and optional validated AIPOU claims.
Maintainers
Readme
AIPOU MCP Server
aipou-mcp-server records private, signed receipts for authorized AI tasks. It supports local receipt collection, reward status checks, and optional claims for validated work on Base.
It does not detect hidden AI use, prove task quality, replace payment rails, or require raw prompts and outputs to leave the user's machine.
Fast Local Adoption Test
If you are evaluating AIPOU for an agent framework, start with the lifecycle adapter example:
npm install
npm run build -w mcp-server
cd examples/lifecycle-adapter
npm install
npm run demoThe demo launches this MCP server over stdio, creates a local signed receipt with an ephemeral wallet, and prints the receiptId reference a framework can attach to metadata. It does not claim rewards or move funds.
Run From npm
MCP clients can launch the published package with:
npx -y aipou-mcp-serverRun locally from this repository
For local development or source review, run the MCP server from a checkout:
npm install
npm run build -w mcp-server
node mcp-server/dist/index.jsFor development:
npm run dev -w mcp-serverRequired configuration:
AIPOU_AGENT_PRIVATE_KEY=<dedicated farming wallet key>
AIPOU_CONTRACT_ADDRESS=0x55f0Cc5e51A1284D20337d6cbb18938C8A1ABCbB
AIPOU_CLAIMS_ADDRESS=0x4ca4C98fB784D20EdC8E2A7F531dAab4c6e53058Use a new dedicated farming wallet, never a primary wallet. Do not commit the private key. Status checks can show already claimed and pending AIPOU without moving funds. Optional claims and settlement occur only after an explicit user request.
Do not configure AIPOU_VALIDATOR_PRIVATE_KEY on a user installation. That key is only for the separate protocol validator service. The local Ed25519 collector key and receipt metadata are stored unencrypted under AIPOU_DATA_DIR; restrict that directory with operating-system permissions and use encrypted backups.
The default network is Base mainnet. AIPOU_RPC_URL and AIPOU_DATA_DIR can be set when a custom RPC endpoint or receipt directory is needed.
Publication details: docs/npm-publication.md.
Documentation
- Local Receipt Mode
- Lifecycle Adapter Example
- Evidence Boundaries
- Claim Validation Policy
- Tokenomics
- Security Policy
License: MIT
