> For the complete documentation index, see [llms.txt](https://printr.gitbook.io/printr-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://printr.gitbook.io/printr-docs/for-agents-new/printr-mcp.md).

# Printr MCP \[NEW]

## What is Printr MCP?

<figure><img src="/files/KXpIvjrorX7UmIrp0Wbr" alt="Printr MCP conversation flow example"><figcaption></figcaption></figure>

Printr MCP is a [Model Context Protocol](https://modelcontextprotocol.io/) server that lets AI agents create, discover, and manage tokens across multiple chains. Think of it as giving Claude, Cursor, or any MCP-compatible AI the power to print tokens on your behalf.

* **GitHub:** <https://github.com/PrintrFi/printr-mcp>
* **NPM:** [@printr/mcp](https://www.npmjs.com/package/@printr/mcp)
* **Developer reference:** [full MCP tool reference](https://printrfi.github.io/printr-mcp/docs/mcp) — every tool, its inputs, and outputs

### Why use it?

* **Zero config** - Works out of the box, no API key needed
* **Multi-chain** - Print tokens on EVM + Solana at once
* **Your keys, your control** - Private keys never touch the AI
* **Browser signing** - Sign with MetaMask or Phantom like normal
* **Local wallet storage** - Encrypted keystore on your machine

***

## Quick Start (Demo Video)

{% embed url="<https://drive.google.com/file/d/1_pm_Ml3NJNX9O35y888qnpU95Nl5pywG/view?usp=sharing>" %}

### Automated Setup (Recommended)

The CLI auto-detects your AI clients and sets everything up:

```bash
# Using Bun (recommended)
bunx @printr/cli setup

# Using Node.js
npx @printr/cli setup

# Want AI-generated token images? Add your OpenRouter key
bunx @printr/cli setup --openrouter-api-key <key>

# Target a specific client
bunx @printr/cli setup --client claude-desktop
```

### One-liner Install

```bash
curl -fsSL https://raw.githubusercontent.com/PrintrFi/printr-mcp/main/scripts/install.sh | bash
```

### Agent Skills

If your agent runtime supports skills, install Printr directly:

```bash
npx skills add PrintrFi/printr-mcp
```

***

## Manual Setup

<details>

<summary>Claude Desktop</summary>

**Config location:**

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Linux: `~/.config/Claude/claude_desktop_config.json`

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

</details>

<details>

<summary>Claude Code CLI</summary>

```bash
claude mcp add --scope user printr -- npx -y @printr/mcp@latest
```

</details>

<details>

<summary>Cursor</summary>

**Config location:** `~/.cursor/mcp.json`

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

</details>

<details>

<summary>VS Code</summary>

Add to your VS Code settings:

```json
{
  "servers": {
    "printr": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@printr/mcp@latest"]
    }
  }
}
```

</details>

***

## Available Tools

Your AI gets access to these tools:

### Token Creation

| Tool                  | What it does                          |
| --------------------- | ------------------------------------- |
| `printr_create_token` | Create tokens with full customization |
| `printr_quote`        | Get cost estimates before printing    |
| `printr_launch_token` | One-call token creation + signing     |

### Token Discovery

| Tool                     | What it does                                    |
| ------------------------ | ----------------------------------------------- |
| `printr_get_token`       | Look up token details by ID or contract address |
| `printr_get_deployments` | Check deployment status and progress per chain  |

### Signing

| Tool                         | What it does                              |
| ---------------------------- | ----------------------------------------- |
| `printr_sign_and_submit_evm` | Sign and submit EVM transactions          |
| `printr_sign_and_submit_svm` | Sign and submit Solana transactions       |
| `printr_open_web_signer`     | Open browser for MetaMask/Phantom signing |

### Wallet Management

| Tool                        | What it does                        |
| --------------------------- | ----------------------------------- |
| `printr_wallet_new`         | Generate new keypairs (EVM/SVM)     |
| `printr_wallet_import`      | Import existing private keys        |
| `printr_wallet_list`        | List all saved wallets              |
| `printr_wallet_unlock`      | Decrypt and activate a saved wallet |
| `printr_wallet_remove`      | Delete wallet from keystore         |
| `printr_wallet_bulk_remove` | Remove multiple wallets at once     |

### Treasury & Deployment Wallets

| Tool                             | What it does                                   |
| -------------------------------- | ---------------------------------------------- |
| `printr_set_treasury_wallet`     | Unlock treasury wallet for funding deployments |
| `printr_fund_deployment_wallet`  | Create and fund an ephemeral deployment wallet |
| `printr_drain_deployment_wallet` | Return unused funds from deployment wallet     |

### Balances & Transfers

| Tool                       | What it does                     |
| -------------------------- | -------------------------------- |
| `printr_get_balance`       | Get native token balance         |
| `printr_get_token_balance` | Get ERC-20/SPL token balance     |
| `printr_transfer`          | Send native tokens to an address |

### Fees

| Tool                      | What it does                           |
| ------------------------- | -------------------------------------- |
| `printr_get_creator_fees` | Check claimable creator fees for token |
| `printr_claim_fees`       | Claim accumulated creator fees         |

### Staking

| Tool                           | What it does                                      |
| ------------------------------ | ------------------------------------------------- |
| `printr_get_staking_positions` | Get staking positions with claimable rewards      |
| `printr_claim_staking_rewards` | Claim rewards from a stake position (or withdraw) |

### Image Generation

| Tool                    | What it does                                      |
| ----------------------- | ------------------------------------------------- |
| `printr_generate_image` | AI-generated token avatars (needs OpenRouter key) |

### Utility

| Tool                      | What it does                              |
| ------------------------- | ----------------------------------------- |
| `printr_supported_chains` | List all supported chains with CAIP-2 IDs |

***

## Configuration

### Environment Variables

#### Core

| Variable              | Description     | Default                            |
| --------------------- | --------------- | ---------------------------------- |
| `PRINTR_API_KEY`      | Partner API key | Public AI-integration key          |
| `PRINTR_API_BASE_URL` | API endpoint    | `https://api-preview.printr.money` |
| `PRINTR_APP_URL`      | Web app URL     | `https://app.printr.money`         |

#### Image Generation (Optional)

| Variable                 | Description        | Default                         |
| ------------------------ | ------------------ | ------------------------------- |
| `OPENROUTER_API_KEY`     | OpenRouter API key | -                               |
| `OPENROUTER_IMAGE_MODEL` | Image model to use | `google/gemini-2.5-flash-image` |

#### Autonomous Mode

For full automation without browser prompts:

| Variable                     | Description                           | Note                                                       |
| ---------------------------- | ------------------------------------- | ---------------------------------------------------------- |
| `EVM_WALLET_PRIVATE_KEY`     | Hex private key for EVM               | Signs without prompts                                      |
| `SVM_WALLET_PRIVATE_KEY`     | Base58 keypair for Solana             | Signs without prompts                                      |
| `AGENT_MODE`                 | Set to `1` for headless mode          | Skips all interactive flows                                |
| `PRINTR_WALLET_STORE`        | Custom keystore path                  | Default: `~/.printr/wallets.json`                          |
| `PRINTR_DEPLOYMENT_PASSWORD` | Master password for deployment wallet | Min 16 chars. Required for `printr_fund_deployment_wallet` |

#### Logging

| Variable     | Description                                          | Default |
| ------------ | ---------------------------------------------------- | ------- |
| `LOG_LEVEL`  | `trace`, `debug`, `info`, `warn`, `error`, `fatal`   | `info`  |
| `LOG_FORMAT` | `json` for structured logs, `pretty` for development | `json`  |

***

## Supported Chains

### EVM (CAIP-2 format)

| Chain           | CAIP-2 ID      |
| --------------- | -------------- |
| Ethereum        | `eip155:1`     |
| Base            | `eip155:8453`  |
| Arbitrum        | `eip155:42161` |
| Avalanche       | `eip155:43114` |
| BNB Smart Chain | `eip155:56`    |
| Monad           | `eip155:143`   |
| Mantle          | `eip155:5000`  |
| Unichain        | `eip155:130`   |
| HyperEVM        | `eip155:999`   |
| MegaETH         | `eip155:4326`  |
| Plasma          | `eip155:9745`  |

### Solana

| Network | CAIP-2 ID                                 |
| ------- | ----------------------------------------- |
| Mainnet | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` |

***

## Signing Options

Three ways to sign transactions:

1. **Browser-based (Recommended)** - Opens MetaMask or Phantom via `printr_open_web_signer`. You stay in control.
2. **Private key input** - Pass keys directly for automation workflows.
3. **Encrypted keystore** - Password-protected local storage at `~/.printr/wallets.json`.

{% hint style="info" %}
Your private keys **never** go to the AI. Signing happens locally in your browser or via encrypted storage.
{% endhint %}

***

## Example Flow

Here's how an AI agent might print a token for you:

```
1. printr_quote
   → Get cost estimates for Base + Solana

2. printr_create_token
   → Generate unsigned transactions

3. printr_open_web_signer
   → You connect MetaMask/Phantom in browser
   → Sign the transactions

4. printr_get_deployments
   → Monitor until status = "live"

5. Done! Trade at:
   → https://app.printr.money/trade/{token_id}
```

### Full Automation

Want the AI to handle everything without prompts?

```bash
export EVM_WALLET_PRIVATE_KEY=0x...
export SVM_WALLET_PRIVATE_KEY=...
export AGENT_MODE=1

# Now printr_launch_token goes brrr without interruption
```

***

## Security

* **Keys stay local** - Handled via browser, encrypted keystore, or env vars only
* **Session isolation** - Bound to `127.0.0.1` with 30-minute TTL
* **AES-256 encryption** - Stored wallets use AES-256-GCM + scrypt
* **Balance checks** - Verifies funds before signing

***

## Using the SDK Directly

For programmatic access without MCP, install the SDK:

```bash
npm install @printr/sdk
# or
bun add @printr/sdk
```

### Quick Example

```typescript
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);

if (result.isOk()) {
  console.log('Token created:', result.value.token_id);
}
```

### SDK Modules

```typescript
// Main exports
import { createPrintrClient, buildToken } from '@printr/sdk';

// Chain information
import { CHAIN_META, getChainMeta } from '@printr/sdk/chains';

// EVM operations
import { signAndSubmitEvm } from '@printr/sdk/evm';

// Solana operations
import { signAndSubmitSvm } from '@printr/sdk/svm';

// Balance queries
import { checkEvmBalance, checkSvmBalance } from '@printr/sdk/balance';

// Token transfers
import { executeTransfer } from '@printr/sdk/transfer';

// Wallet keystore
import { addWallet, listWallets } from '@printr/sdk/keystore';

// Image generation
import { generateImageFromPrompt } from '@printr/sdk/image';

// CAIP utilities
import { parseCaip2, parseCaip10 } from '@printr/sdk/caip';

// Staking API
import { listStakePositionsWithRewards, claimStakingRewards } from '@printr/sdk';
```

***

## Resources

* [GitHub](https://github.com/PrintrFi/printr-mcp)
* [NPM - MCP](https://www.npmjs.com/package/@printr/mcp)
* [Printr SDK](/printr-docs/for-developers/printr-sdk.md)
* [Printr API Docs](https://api-preview.printr.money/login#description/introduction)
* [Model Context Protocol](https://modelcontextprotocol.io/)