@printr/mcp

MCP server for Printr — lets AI agents create, discover, and track tokens across chains.

No API key required. Works out of the box.

Setup

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
    "mcpServers": {
        "printr": {
            "command": "npx",
            "args": ["-y", "@printr/mcp@latest"]
        }
    }
}

Or with bunx:

{
    "mcpServers": {
        "printr": {
            "command": "bunx",
            "args": ["@printr/mcp@latest"]
        }
    }
}

Skills

If your agent runtime supports skills, you can install Printr directly:

npx skills add PrintrFi/printr-mcp

See the skill definition for details.

Optional capabilities

Auto-generate token images

Set OPENROUTER_API_KEY and the agent will generate an image automatically when you create a token without supplying one. The printr_generate_image tool also becomes available for standalone image generation.

"env": {
    "OPENROUTER_API_KEY": "<your-openrouter-key>"
}

Let the agent sign transactions autonomously

By default, token creation returns an unsigned transaction that you sign via browser wallet or by passing a private key per call. If you want the agent to sign and submit without prompting, set a default key:

"env": {
    "EVM_WALLET_PRIVATE_KEY": "<hex-private-key>",
    "SVM_WALLET_PRIVATE_KEY": "<base58-keypair-secret>"
}

Keep private keys out of shared configs. Use environment-level secrets when possible.

Tools

Environment variables

Dev / self-hosting

Development

This is a monorepo with three packages:

• @printr/sdk — Core TypeScript SDK (framework-agnostic)
• @printr/mcp — MCP server wrapping the SDK
• @printr/cli — CLI for setup and configuration

bun install
bun dev          # Run MCP server with hot reload
bun test         # Run all tests
bun run check    # typecheck + lint + test

Package-specific commands

# SDK
bun run --cwd packages/sdk test
bun run --cwd packages/sdk build

# MCP
bun run --cwd packages/mcp test
bun run --cwd packages/mcp build

Using the SDK directly

import { createPrintrClient, buildToken } from '@printr/sdk';

const client = createPrintrClient({
  apiKey: process.env.PRINTR_API_KEY,
});

const result = await buildToken({
  creator_accounts: ['eip155:8453:0x...'],
  name: 'My Token',
  symbol: 'TKN',
  description: 'A cool token',
  chains: ['eip155:8453'],
  initial_buy: { spend_usd: 10 },
}, client);