Metadata-Version: 2.4
Name: kultur-mcp
Version: 1.0.1
Summary: Kultur.dev Cultural Intelligence MCP Server — analyze content for 195 countries
Author-email: "Kultur.dev" <contact@kultur.dev>
License: MIT
Project-URL: Homepage, https://kultur.dev
Project-URL: Documentation, https://kultur.dev/docs
Project-URL: Repository, https://github.com/kultur-dev/mcp-server
Keywords: mcp,cultural-intelligence,hofstede,localization,i18n,sensitivity
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: click>=8.0.0
Dynamic: license-file

<div align="center">

<img src="https://raw.githubusercontent.com/kultur-dev/mcp-server/main/assets/kultur-globe-icon.png" alt="Kultur.dev" width="140" />

# kultur-mcp

<!-- mcp-name: dev.kultur/mcp-server -->

### Cultural Intelligence MCP Server for AI Agents

[![PyPI](https://img.shields.io/pypi/v/kultur-mcp.svg)](https://pypi.org/project/kultur-mcp/)
[![PyPI downloads](https://img.shields.io/pypi/dm/kultur-mcp.svg?label=PyPI%20downloads)](https://pypi.org/project/kultur-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
[![Countries](https://img.shields.io/badge/countries-195-teal.svg)](https://kultur.dev)

</div>

---

Connect any MCP-compatible AI agent to the world's largest cultural intelligence knowledge base. Analyze cultural sensitivity, retrieve Hofstede dimensions, check localization readiness, and generate communication guides across **195 countries**.

## Install

```bash
pip install kultur-mcp
```

## Usage

```bash
# With API key flag
kultur-mcp --api-key YOUR_KEY

# With environment variable
export KULTUR_API_KEY=YOUR_KEY
kultur-mcp

# Health check
kultur-mcp --health
```

## Configuration

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "kultur-dev": {
      "command": "kultur-mcp",
      "args": ["--api-key", "YOUR_KEY"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "kultur-dev": {
      "command": "kultur-mcp",
      "args": ["--api-key", "YOUR_KEY"]
    }
  }
}
```

### Windsurf / VS Code

```json
{
  "mcp.servers": {
    "kultur-dev": {
      "command": "kultur-mcp",
      "args": ["--api-key", "YOUR_KEY"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `analyze_cultural_sensitivity` | Analyze text for cultural appropriateness in target markets |
| `get_cultural_dimensions` | Retrieve Hofstede's 6 cultural dimensions for a country |
| `check_localization_readiness` | Evaluate content readiness for a target market |
| `get_communication_style_guide` | Get business communication norms by country |
| `get_business_etiquette` | Meeting, greeting, and negotiation rules |
| `analyze_market_entry_readiness` | Assess cultural barriers for market entry |

## CLI Options

```
--api-key KEY    Your Kultur.dev API key
--sse-url URL    Custom SSE endpoint
--health         Check server health and exit
--version        Print version
--help           Show help
```

## Get Your API Key

| Plan | Credits/month | Price |
|------|--------------|-------|
| Discovery | 1,000 | Free |
| Pro | 10,000 | $49/mo |
| Enterprise | Custom | Contact us |

**[Get your API key →](https://kultur.dev/pricing)**

## License

MIT — [kultur.dev](https://kultur.dev)
