# ChemFlow MCP Server

> Professional chemical engineering simulation MCP (Model Context Protocol) server. 
> Connect your AI assistant to CFD simulation, thermodynamics, flowsheet solving, equipment design, and more.

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
[![License: CCLA v1.0](https://img.shields.io/badge/License-CCLA%20v1.0-orange)](LICENSE)
[![Status: Production](https://img.shields.io/badge/Status-Production-green)]()

---

## Overview

ChemFlow MCP provides **12 professional chemical engineering tools** accessible to any MCP-compatible AI client (Claude, Trae, Cursor, Windsurf, etc.):

| # | Tool | Description |
|---|------|-------------|
| 1 | `chemflow_run_cfd` | Run CFD (Computational Fluid Dynamics) simulations |
| 2 | `chemflow_query_compound` | Query chemical compound properties (from ChemSep database) |
| 3 | `chemflow_design_equipment` | Design chemical equipment (distillation, heat exchanger, etc.) |
| 4 | `chemflow_solve_dynamic` | Solve dynamic process simulation |
| 5 | `chemflow_solve_flowsheet` | Solve steady-state flowsheet |
| 6 | `chemflow_optimize` | Optimize process parameters |
| 7 | `chemflow_screen_route` | Screen synthetic routes |
| 8 | `chemflow_generate_engineering_prompt` | Generate engineering-specific prompts |
| 9 | `chemflow_query_knowledge_table` | Query engineering knowledge tables |
| 10 | `chemflow_run_simulation` | Run general-purpose simulation |
| 11 | `chemflow_run_flash` | Run flash calculations (PT, PH, PS, etc.) |
| 12 | `chemflow_scale_up` | Validate scale-up feasibility (lab to plant) |

---

## Quick Start

### Step 1: Get an API Key

Visit [unveilchem.com](https://unveilchem.com) to obtain your ChemFlow API Key.

### Step 2: Configure Your AI Client

#### Option A: Trae (International)

Click this link (replace `YOUR_API_KEY` with your actual key):

```
trae://trae.ai-ide/mcp-import?type=http&name=chemflow&config=<base64_encoded_config>
```

Or manually add in Trae IDE → Settings → MCP → Add → Manual:

```json
{
  "mcpServers": {
    "chemflow": {
      "url": "https://unveilchem.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

#### Option B: Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "chemflow": {
      "url": "https://unveilchem.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

#### Option C: Cursor / Windsurf / Other MCP Clients

```json
{
  "mcpServers": {
    "chemflow": {
      "url": "https://unveilchem.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Step 3: Verify Connection

Ask your AI assistant: *"List available ChemFlow tools"*

You should see 12 tools listed.

---

## Server Endpoints

| Region | Endpoint | Status |
|--------|----------|--------|
| China (Hangzhou) | `https://unveilchem.com/mcp` | Online |

Health check: `https://unveilchem.com/health`

> Note: The Singapore endpoint (`mcp.intl.unveilchem.com`) has been retired.

---

## Pricing

| Plan | Daily Quota | Price | Target |
|------|------------|-------|--------|
| Free | 1,000 calls/day | $0 | Students, evaluation |
| Pro | 100,000 calls/day | $2.99/mo | Individual engineers |
| Team | 500,000 calls/day (5 seats) | $14.99/mo | Small teams |
| Enterprise | Unlimited | Custom | Enterprise |

Visit [unveilchem.com](https://unveilchem.com) for details.

---

## Authentication

All requests require an API Key passed via the `Authorization` header:

```
Authorization: Bearer cf_your_api_key_here
```

API Keys are managed through the ChemFlow dashboard.

---

## Technical Details

- **Protocol**: MCP Streamable HTTP (JSON-RPC 2.0 over HTTP)
- **Transport**: HTTPS with TLS 1.2/1.3
- **Authentication**: API Key (SHA-256 hashed storage)
- **Rate Limiting**: Daily quota + RPS constraints
- **Data Sources**: ChemSep (Artistic 2.0), CoolProp (MIT), LLNL reaction mechanisms

---

## License

ChemFlow Commercial License Agreement (CCLA) v1.0
- Non-commercial use: Free
- Commercial use: Requires authorization

See [LICENSE](LICENSE) for full terms.

---

## Links

- Website: [unveilchem.com](https://unveilchem.com)
- Documentation: [docs.unveilchem.com](https://docs.unveilchem.com)
- Support: contact@unveilchem.com
- Smithery: [smithery.ai/servers/unveilchem/chemflow](https://smithery.ai)
- ModelScope: [modelscope.cn/mcp](https://www.modelscope.cn/mcp)

---

© 2026 UnveilChem. All rights reserved.