Connecting to the Passcreator MCP Server

Connect your AI assistant to Passcreator to manage mobile wallet passes, templates, and customer segments using natural language.

---

Prerequisites

• A Passcreator account with an API key. You can find your API key in the Passcreator dashboard under Settings > API.
• An MCP-compatible AI client (see setup instructions below).

---

How It Works

When you connect a client for the first time, the following happens automatically:

1. Your AI client discovers the Passcreator MCP server
2. A browser window opens asking you to enter your Passcreator API key
3. After entering your key, the browser redirects back to your AI client
4. You're connected — start managing passes with natural language

Your API key is encrypted at rest (AES-256-GCM) and never logged. Tokens refresh automatically, so you only need to authenticate once.

---

Claude Desktop

1. Open Claude Desktop and click Customize in the left sidebar (above your chat list)
2. In the left menu, click Connectors
3. Click the + button at the top of the connector list
4. Select "Add custom connector"
5. Enter the URL: https://mcp.passcreator.com/mcp and give it a name (e.g. Passcreator)
6. Click on the newly added connector (e.g. "Passcreator") in the list
7. Your browser opens — enter your Passcreator API key to authorize

Alternatively, edit your config file directly:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "passcreator": {
      "type": "url",
      "url": "https://mcp.passcreator.com/mcp"
    }
  }
}

Once connected, you can ask Claude things like:

• "List all my pass templates"
• "Search for passes with barcode value ABC123"
• "Send a push notification to pass XYZ"

---

Claude Code (CLI)

Add the server from the command line:

claude mcp add passcreator --transport http https://mcp.passcreator.com/mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "passcreator": {
      "type": "url",
      "url": "https://mcp.passcreator.com/mcp"
    }
  }
}

The first time a Passcreator tool is used, your browser opens for authentication.

---

ChatGPT

1. In ChatGPT, go to Settings > Connected Apps > MCP
2. Click "Add MCP server"
3. Enter the URL: https://mcp.passcreator.com/mcp
4. ChatGPT auto-discovers the available tools

When you first use a Passcreator tool, ChatGPT opens the authorization page in your browser. Enter your API key and you're connected.

---

Cursor

1. Open Cursor Settings (Cmd+, on macOS / Ctrl+, on Windows)
2. Go to the MCP section
3. Click "Add new MCP server"
4. Select type "URL" and enter: https://mcp.passcreator.com/mcp

Or add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "passcreator": {
      "type": "url",
      "url": "https://mcp.passcreator.com/mcp"
    }
  }
}

---

Windsurf

Add to ~/.windsurf/mcp.json (or your project's .windsurf/mcp.json):

{
  "mcpServers": {
    "passcreator": {
      "type": "url",
      "serverUrl": "https://mcp.passcreator.com/mcp"
    }
  }
}

---

Copilot Studio

1. In Copilot Studio, open your agent
2. Go to Actions > Add an action > MCP tool
3. Enter the server URL: https://mcp.passcreator.com/mcp
4. Select which Passcreator tools to enable for your agent

---

Other MCP Clients

Any client that supports the Model Context Protocol can connect by pointing to:

https://mcp.passcreator.com/mcp

The server supports:

• OAuth 2.1 auto-discovery via /.well-known/oauth-authorization-server
• Dynamic Client Registration (RFC 7591)
• PKCE (S256) for secure authorization
• Streamable HTTP transport (MCP spec 2025-06-18)

---

Available Tools

Once connected, the following tools are available:

Pass Management

Tool	Description
searchPasses	Search for passes using advanced filters and the Passcreator query language
createOrUpdatePass	Create a new pass or update an existing one
createOrUpdatePassesBulk	Create or update multiple passes at once
deletePass	Delete a specific pass
getProcessStatus	Check the progress of a bulk operation

Templates

Tool	Description
listPassTemplates	List all available pass templates
getPassTemplate	Get the details and fields of a specific template

Delivery

Tool	Description
deliverPass	Send a pass to a customer via email or SMS
sendPushNotification	Send a push notification to a pass on the customer's device

Segments & System

Tool	Description
getSegments	List all customer segments
healthCheck	Check the Passcreator API status

---

Example Prompts

Here are some things you can ask your AI assistant once connected:

What you want to do	Example prompt
Browse templates	"Show me all my pass templates"
Search passes	"Find all passes created in the last 7 days"
Inspect a template	"What fields does the Boarding Pass template have?"
Create a pass	"Create a new pass from template X with the name John Doe and email john@example.com"
Update a pass	"Update pass ABC123 and set the loyalty points to 500"
Send a pass	"Send pass ABC123 to john@example.com via email"
Push notification	"Send a push notification to pass ABC123 saying 'Your flight is boarding'"
Bulk operations	"Create 10 passes from template X with these names: ..."
Check status	"What's the status of bulk operation XYZ?"

---

Troubleshooting

Browser window doesn't open

• Verify you can reach the server: open https://mcp.passcreator.com/health in your browser — it should show {"status":"healthy"}
• Make sure your AI client is up to date and supports remote MCP servers

"Invalid Passcreator API key"

• Double-check your API key in the Passcreator dashboard under Settings > API
• The key is validated against the Passcreator API during authorization

Authorization succeeds but tools don't appear

• Restart your AI client after connecting
• Some clients may take a moment to discover the available tools

"Token expired" or "Unauthorized" errors

• Tokens refresh automatically. If refresh fails, disconnect and reconnect the MCP server in your client to re-authorize
• In Claude Desktop: remove the server entry, restart, and add it again

Rate limit errors (429)

• The server allows 100 requests per minute
• If you hit the limit, wait a minute and try again
• Bulk operations count as a single request

Connection drops or timeouts

• This can happen if your network has aggressive timeout settings
• The connection will automatically recover on the next request

---

Support

If you need help or encounter issues:

• Email: support@passcreator.com
• Passcreator Dashboard: app.passcreator.com
• API Documentation: developer.passcreator.com