MCP Setup

Promptmark exposes a Model Context Protocol (MCP) server that lets AI assistants manage your prompt library. This guide covers connecting popular MCP clients.

Connection

Connect to Promptmark’s MCP server over Streamable HTTP:

URL: https://promptmark.ai/mcp
Auth: Bearer JWT or OAuth Device Flow

Client Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "promptmark": {
      "url": "https://promptmark.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Code

Add to your project’s .mcp.json or global MCP settings:

{
  "mcpServers": {
    "promptmark": {
      "url": "https://promptmark.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Cursor

In Cursor Settings > MCP Servers, add:

{
  "promptmark": {
    "url": "https://promptmark.ai/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_TOKEN"
    }
  }
}

Warp

In Warp’s MCP configuration:

{
  "mcpServers": {
    "promptmark": {
      "serverUrl": "https://promptmark.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

OAuth Device Flow

For MCP clients that support OAuth 2.0 device authorization:

1. The client discovers Promptmark’s auth endpoints via:

   • GET /.well-known/oauth-protected-resource (RFC 9728)
   • GET /.well-known/oauth-authorization-server (RFC 8414)

2. The client initiates a device flow to POST /api/oauth/device/code

3. You approve the request in your browser at the verification URL

4. The client automatically receives a Bearer token

This is the most seamless experience — no manual token copying required.

Verifying the Connection

Once connected, ask your AI assistant to list your prompts:

“List my prompts in Promptmark”

The assistant should call the list_prompts MCP tool and return your prompt library. If you see an authentication error, verify your token or API key.

Available Tools

After connecting, your AI assistant has access to 29 tools across these categories:

See MCP Reference for detailed documentation of every tool.