io.github.PrintrFi/printr
Let AI agents create, discover, and track tokens across chains via Printr.
Open source Open in the app JSON README (API)
About
Let AI agents create, discover, and track tokens across chains via Printr.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- printrfi
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.4.1
- Stars
- 3
- Forks
- 3
- Last push
- 2026-07-17T23:26:51Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:10
- Updated
- 2026-08-29 03:02:10
- Origin id
io.github.PrintrFi/printr
README
# @printr/mcp
[](https://www.npmjs.com/package/@printr/mcp)
[](https://www.npmjs.com/package/@printr/mcp)
[](https://github.com/PrintrFi/printr-mcp/blob/main/LICENSE)
[](https://github.com/PrintrFi/printr-mcp/actions/workflows/ci.yml)
[](https://codecov.io/gh/PrintrFi/printr-mcp)
[](https://skills.sh/PrintrFi/printr-mcp)
MCP server for [Printr](https://printr.money) — the cross-chain token launchpad built for holders. Lets AI agents launch, stake, and graduate tokens across EVM chains and Solana.
No API key required. Works out of the box.
📖 **[Documentation](https://printrfi.github.io/printr-mcp/)**
## Setup
Add to your MCP client config (Claude Desktop, Cursor, etc.):
```json
{
"mcpServers": {
"printr": {
"command": "npx",
"args": ["-y", "@printr/mcp@latest"]
}
}
}
```
Or with `bunx`:
```json
{
"mcpServers": {
"printr": {
"command": "bunx",
"args": ["@printr/mcp@latest"]
}
}
}
```
## Skill (optional, complements the MCP config above)
In addition to the MCP config, install the Printr skill to give your agent built-in guidance on when and how to use these tools. Compatible with Claude Code, Cursor, Codex, OpenCode, and [50+ other runtimes](https://www.skills.sh).
```sh
npx skills add PrintrFi/printr-mcp
```
Preview without installing:
```sh
npx skills add PrintrFi/printr-mcp --list
```
The skill is auto-discovered from `packages/cli/skills/printr/SKILL.md`. See the [skill definition](packages/cli/skills/printr/SKILL.md) for the full tool list and behavioral hints.
## 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.
```json
"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:
```json
"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
| Tool | Description |
| --------------------------- | -------------------------------------------------------------------- |
| [`printr_quote`](packages/mcp/src/tools/quote.ts) | Get cost estimates for token creation |
| [`printr_create_token`](packages/mcp/src/tools/create-token.ts) | Generate an unsigned token creation tx payload |
| [`printr_launch_token`](packages/mcp/src/tools/launch-token.ts) | Create and sign a token in one call |
| [`printr_get_token`](packages/mcp/src/tools/get-token.ts) | Look up token details by ID or address |
| [`printr_get_deployments`](packages/mcp/src/tools/get-deployments.ts) | Check deployment status across target chains |
| [`printr_sign_and_submit_evm`](packages/mcp/src/tools/sign-and-submit-evm.ts) | Sign and submit an EVM tx payload |
| [`printr_sign_and_submit_svm`](packages/mcp/src/tools/sign-and-submit-svm.ts) | Sign and submit a Solana tx payload |
| [`printr_open_web_signer`](packages/mcp/src/tools/open-web-signer.ts) | Start a browser signing session (MetaMask / Phantom) |
| [`printr_generate_image`](packages/mcp/src/tools/generate-image.ts) | Generate a token avatar via OpenRouter (requires `OPENROUTER_API_KEY`)|
For the full tool list including wallet, balance, transfer, fees, and staking tools, see [`packages/cli/skills/printr/SKILL.md`](packages/cli/skills/printr/SKILL.md).
## Environment variables
| Variable | Description |
| ----------------------------- | ---------------------------------------------------------------------- |
| `PRINTR_API_KEY` | Partner API key. Falls back to the default public AI-integration key. |
| `OPENROUTER_API_KEY` | Enables auto image generation and the `printr_generate_image` tool |
| `OPENROUTER_IMAGE_MODEL` | Image model override (default: `google/gemini-2.5-flash-image`) |
| `EVM_WALLET_PRIVATE_KEY` | Default EVM private key for autonomous signing |
| `SVM_WALLET_PRIVATE_KEY` | Default Solana keypair secret for autonomous signing |
| `PRINTR_DEPLOYMENT_PASSWORD` | Master password for encrypting deployment wallets (min 16 chars). Required for `printr_fund_deployment_wallet`. Generate with: `openssl rand -base64 32` |
### Dev / self-hosting
| Variable | Description |
| ------------------------- | ---------------------------------------------------------------------- |
| `PRINTR_API_BASE_URL` | Override API base URL (default: `https://api-preview.printr.money`) |
| `PRINTR_APP_URL` | Override app URL (default: `https://app.printr.money`) |
## Development
This is a monorepo with three packages:
- [`@printr/sdk`](packages/sdk) — Core TypeScript SDK (framework-agnostic)
- [`@printr/mcp`](packages/mcp) — MCP server wrapping the SDK
- [`@printr/cli`](packages/cli) — CLI for setup and configuration
```sh
bun install
bun dev # Run MCP server with hot reload
bun test # Run all tests
bun run check # typecheck + lint + test
```
### Package-specific commands
```sh
# 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
Uses [`createPrintrClient`](packages/sdk/src/client.ts) and [`buildToken`](packages/sdk/src/token.ts):
```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);
```