MCP Server

The Scrift MCP server lets Claude, Cursor, Windsurf, and other MCP-compatible hosts look up brand logos and colors directly in conversation - without writing any code. It is always free on all Scrift tiers.

What you can do

Ask your AI assistant things like:

• "Add the Stripe logo to this React component"
• "What's GitHub's brand color?"
• "Get me the Vercel SVG in dark mode"
• "Fetch logos for Stripe, PayPal, and Apple in one call"

The server handles the API call and returns exactly what you need.

Available tools

Tool	Description	When to use
get_brand	Get brand data by slug (name, colors, CSS vars, variants)	When you know the exact slug
search_brands	Search brands by name or keyword	When you need to find a slug
get_svg	Get raw SVG markup for a brand logo	When you need the actual SVG string
get_brand_by_domain	Look up a brand by domain (e.g. stripe.com)	When you have a domain, not a slug
batch_get_brands	Get data for up to 50 brands in one call	When you need multiple brands at once

Installation

Requires Python 3.13+ and uv.

git clone https://github.com/phazeo/scrift
cd scrift/mcp
uv sync

Configuration

Get a free API key at scrift.app.

export SCRIFT_API_KEY=your_api_key_here

Claude Desktop

Add to your claude_desktop_config.json (location: ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "scrift": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/scrift/mcp", "run", "scrift-mcp"],
      "env": {
        "SCRIFT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace /absolute/path/to/scrift/mcp with the actual path. Run pwd inside the mcp/ directory to get it.

Claude Code

claude mcp add scrift -- uv --directory /absolute/path/to/scrift/mcp run scrift-mcp

Then set SCRIFT_API_KEY in your shell environment.

Cursor / Windsurf

Use the same JSON config format as Claude Desktop. Refer to your client's MCP configuration documentation for the config file location.

Debugging

cd mcp/
uv run mcp dev server.py

This opens the MCP Inspector at http://localhost:5173 - a browser UI where you can list tools, call them with test inputs, and inspect raw JSON-RPC messages.

Logs are written to stderr only and appear in your MCP client's log output (e.g. ~/Library/Logs/Claude/mcp-*.log on macOS with Claude Desktop).

Security

Never commit your API key. Use environment variables or your MCP host's secrets management. The server reads SCRIFT_API_KEY from the environment at runtime and logs a warning to stderr if it is not set.