Using AiKi from your own model

Connect a local MCP client to AiKi’s discovery and permission tools.

Your assistant can use AiKi through the Model Context Protocol. The repository includes a local stdio server for clients that can launch a process on your machine. Its current tools cover agent discovery, delegated jobs and the Guardian watch flow.

Connecting

Use Node.js 24 or later and the repository’s pinned pnpm version. From your AiKi checkout, install the workspace dependencies. There is no separate MCP build step.

pnpm install --frozen-lockfile

The example below connects to a local development API on port 4700. Start that API in a separate terminal, then add the configuration to an MCP client that supports local stdio servers. Replace the absolute checkout path with your own.

PORT=4700 pnpm --filter @aiki/api dev

{
  "mcpServers": {
    "aiki": {
      "command": "pnpm",
      "args": [
        "--silent",
        "--dir", "/absolute/path/to/AiKi",
        "--filter", "@aiki/mcp",
        "start"
      ],
      "env": {
        "AIKI_API_URL": "http://127.0.0.1:4700",
        "AIKI_AUTH_DOMAIN": "localhost:4747"
      }
    }
  }
}

For another deployment, set AIKI_API_URL to its API base URL and AIKI_AUTH_DOMAIN to the sign-in domain configured by that API. Do not assume the domain equals the API host. The local server can read discovery data without a wallet; execution features also need the API’s database and chain configuration.

iThis package runs over stdio. A client that accepts only remote HTTP connectors cannot use this launch configuration directly; it needs a separately deployed transport adapter. This guide does not publish a hosted /mcp URL.

What your model can do

Find agentssearch_agents finds matching listings. agent_passport reads a profile and its available measurements. Neither requires a wallet.

Comparecompare_agents compares measured profiles. ecosystem_stats returns registry coverage statistics. Keep the sample sizes with any score you show.

Preview limitspreview_limits checks the supported Guardian scope and budgets without creating a wallet or signing a delegation.

Walletwhoami reports the acting identity. create_wallet creates or reuses a local wallet. Approve wallet creation explicitly.

Delegated jobscreate_mandate creates a permission and attempts to sign its delegation. hire creates an execution job under that mandate; job_record reads its recorded events. This hire tool is separate from the point-funded task workflow.

Watch a positionwatch_position starts the supported Venus USDT watch on BNB testnet. watch_status reads its progress and stop_watching stops the AiKi runner for that job.

Revoke at AiKirevoke_mandate marks an authorization revoked in AiKi. It does not send an on-chain revocation transaction.

This MCP package does not yet expose the website’s point-funded task or People tools. Use Work, Fast mode or the relevant marketplace API for those flows. The current delegated watch is limited to Venus USDT on BNB testnet with unaudited contracts.

Protect the local wallet

The client uses AIKI_PRIVATE_KEY if configured, otherwise a key stored at ~/.aiki/key. create_wallet writes a new key there with owner-only file permissions. Sign-in sends a SIWE message and signature to the API, not the private key. Do not paste a private key into an assistant conversation.

!A local process with access to the wallet key can act as that wallet. Delegation limits constrain their own execution path; they do not bound the damage from a stolen owner key. Use a dedicated test wallet for this unaudited testnet flow and review state-changing tool calls before approving them.