# QR Business Cards MCP Server

Create professional QR business cards through any MCP-compatible AI assistant (Claude, Cursor, Windsurf, etc.). No API key required.

**Server URL:** `https://qr-business-cards.com/api/mcp`

## What it does

Your AI assistant can:
- **Create a QR business card profile** — name, title, email, phone, bio, social links, theme
- **Look up existing profiles** — retrieve profile details by ID
- **Get pricing & packages** — 50/100/250 printed cards shipped to your door

Each profile gets a public URL with a QR code. Scan it to see the digital business card. Order printed cards from $23.99 (with promo code LAUNCH20 for 20% off).

## Setup

### Claude Desktop / Claude Code

Add to your MCP config (`claude_desktop_config.json` or `.mcp.json`):

```json
{
  "mcpServers": {
    "qr-business-cards": {
      "type": "url",
      "url": "https://qr-business-cards.com/api/mcp"
    }
  }
}
```

### Cursor

Add to your MCP settings:

```json
{
  "mcpServers": {
    "qr-business-cards": {
      "url": "https://qr-business-cards.com/api/mcp"
    }
  }
}
```

### Any MCP Client

The server uses **Streamable HTTP transport** over JSON-RPC 2.0. Point your client to:

```
POST https://qr-business-cards.com/api/mcp
Content-Type: application/json
```

## Tools

### `create_profile`

Create a new QR business card profile.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Full name |
| `title` | string | No | Job title or tagline |
| `email` | string | No | Contact email |
| `phone` | string | No | Phone number |
| `bio` | string | No | Full bio for digital profile |
| `cardBio` | string | No | Short bio for printed card (max 200 chars) |
| `socialLinks` | object | No | `{ linkedin, twitter, github, website }` |
| `theme` | string | No | `noir` (white on black) or `classic` (black on white) |

Returns: profile ID, public URL, QR code URL, edit token, and order link.

### `get_profile`

Look up an existing profile by ID.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Profile ID or slug |

### `get_packages`

Get available packages and pricing. No parameters required.

## Example

Ask your AI assistant:

> "Create a QR business card for me. My name is Jane Smith, I'm a Product Designer at Acme Corp. Use the noir theme."

The assistant will call `create_profile`, and you'll get back a link to your digital profile and an order page for printed cards.

## Pricing

| Package | Cards | Price |
|---------|-------|-------|
| Starter | 50 | $29.99 |
| Professional | 100 | $49.99 |
| Business | 250 | $109.99 |

Use promo code **LAUNCH20** for 20% off — ends April 18.

Free shipping included with every order. Premium 14pt card stock.

## Links

- **Website:** [qr-business-cards.com](https://qr-business-cards.com)
- **Create a Card:** [qr-business-cards.com/qr-business-card/create](https://qr-business-cards.com/qr-business-card/create)
- **OpenAPI Spec:** [qr-business-cards.com/api/openapi](https://qr-business-cards.com/api/openapi)
- **Developer Docs:** [qr-business-cards.com/developers](https://qr-business-cards.com/developers)
- **Compare Alternatives:** [qr-business-cards.com/compare](https://qr-business-cards.com/compare)

## License

MIT