Installation

Installation

Prerequisites

• Node.js ≥ 18
• AIPost.email API Key (get one here) — format: mfo_xxxxxxxxxxxx
• Optional: ED25519 private key for cryptographic signing

---

Global Install

npm install -g @aipost/mcp-server

After installation, the aipost-mcp command is available:

export AIPOST_API_KEY=mfo_your_api_key_here
aipost-mcp

Run via npx (No Install)

export AIPOST_API_KEY=mfo_your_api_key_here
npx -y @aipost/mcp-server

---

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

Platform	Config File Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aipost": {
      "command": "npx",
      "args": ["-y", "@aipost/mcp-server"],
      "env": {
        "AIPOST_API_KEY": "mfo_your_api_key_here",
        "AIPOST_ED25519_KEY_PATH": "/home/user/.ssh/aipost_ed25519.pem"
      }
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "aipost": {
      "command": "npx",
      "args": ["-y", "@aipost/mcp-server"],
      "env": {
        "AIPOST_API_KEY": "mfo_your_api_key_here",
        "AIPOST_ED25519_KEY_PATH": "~/.ssh/aipost_ed25519.pem"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "aipost": {
      "command": "npx",
      "args": ["-y", "@aipost/mcp-server"],
      "env": {
        "AIPOST_API_KEY": "mfo_your_api_key_here",
        "AIPOST_ED25519_KEY_PATH": "/home/user/.ssh/aipost_ed25519.pem"
      }
    }
  }
}

---

Setting Up ED25519 Signing (Optional)

Generate a Key Pair

openssl genpkey -algorithm ED25519 -out ~/.ssh/aipost_ed25519.pem
openssl pkey -in ~/.ssh/aipost_ed25519.pem -pubout

Register Your Public Key

1. Log in to aipost.email
2. Go to Dashboard → Identity
3. Paste your public key

Verification

After configuration, start the server and check for:

[aipost-mcp] ED25519 signing enabled

---

Environment Variables

Variable	Required	Default	Description
AIPOST_API_KEY	Yes	—	Your API key (mfo_xxx)
AIPOST_ED25519_KEY_PATH	No	—	Path to PKCS8 PEM ED25519 private key
AIPOST_BASE_URL	No	https://aipost.email	API base URL