Typiva MCP Server

An MCP (Model Context Protocol) server that gives AI coding agents access to Typiva's typography and design intelligence.

Tools

| Tool | Description | |------|-------------| | typiva_suggest_fonts | Get AI-powered font pairing recommendations with usage guidelines, weights, and typography scale | | typiva_find_similar | Find free Google Font or Fontshare alternatives to any font, with similarity scores | | typiva_suggest_palette | Generate accessible UI color palettes with design tokens and CSS custom properties |

Quick Start (Recommended)

No install required — just add a config and go.

1. Get an API Key

Sign in at typiva.app/api-docs and create a free API key.

2. Add the Config

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global access):

{
  "mcpServers": {
    "typiva": {
      "command": "npx",
      "args": ["-y", "@typiva/mcp-server"],
      "env": {
        "TYPIVA_API_KEY": "tvp_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "typiva": {
      "command": "npx",
      "args": ["-y", "@typiva/mcp-server"],
      "env": {
        "TYPIVA_API_KEY": "tvp_your_key_here"
      }
    }
  }
}

3. Restart Your Editor

Restart Cursor or Claude Desktop to pick up the new MCP server. That's it!

For full setup instructions with screenshots, visit typiva.app/mcp.

Usage Examples

Once configured, your AI agent can use Typiva tools naturally:

Font suggestions:

"I need fonts for a fintech landing page with a modern, trustworthy feel"

The agent will call typiva_suggest_fonts and return a structured font pairing with CSS imports.

Font alternatives:

"Find me a free alternative to Proxima Nova"

The agent will call typiva_find_similar and return ranked alternatives from Google Fonts and Fontshare.

Color palettes:

"Generate a color palette for a healthcare app, professional mood, starting with #2563eb"

The agent will call typiva_suggest_palette and return a full palette with design tokens and CSS variables.

Rate Limits

• Free tier: 50 requests per day per API key
• Rate limit errors include a retryAfter field with seconds until reset

Manual Install (Alternative)

If you prefer a global install instead of npx:

npm install -g @typiva/mcp-server

Then use this config instead:

{
  "mcpServers": {
    "typiva": {
      "command": "typiva-mcp",
      "env": {
        "TYPIVA_API_KEY": "tvp_your_key_here"
      }
    }
  }
}

Contributing

Clone the repo and work in the mcp-server/ directory:

cd mcp-server
npm install
npm run dev    # Watch mode (recompiles on changes)
npm run build  # Production build
npm start      # Run the server