Metadata-Version: 2.4
Name: cos-mcp
Version: 0.2.0
Summary: COS (Communication Optimization System) MCP server for Claude
Project-URL: Homepage, https://semalytics.com/cos
Project-URL: Repository, https://github.com/SEMalytics/cos
Author-email: Semalytics <hello@semalytics.com>
License-Expression: MIT
License-File: LICENSE
Keywords: analysis,claude,communication,mcp,nlp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.14.0
Requires-Dist: httpx>=0.27.0
Description-Content-Type: text/markdown

# COS MCP Server

[MCP](https://modelcontextprotocol.io) server for the **Communication Optimization System (COS)** — analyze content for engagement, personality fit, strategic clarity, and cognitive framing.

## Quick Start

```bash
# Install
pip install cos-mcp

# Set your API key
export COS_API_KEY="your-cos-api-key"

# Run (stdio mode for Claude Desktop / Claude Code)
cos-mcp
```

### Claude Code

```bash
claude mcp add cos-mcp -- cos-mcp
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cos": {
      "command": "cos-mcp",
      "env": {
        "COS_API_KEY": "your-cos-api-key"
      }
    }
  }
}
```

### Remote (zero-install)

```bash
claude mcp add --transport http cos https://mcp.semalytics.io/mcp \
  --header "Authorization: Bearer YOUR_COS_API_KEY"
```

## Tools

| Tool | Credits | Description |
|------|---------|-------------|
| `chat` | 1 | Conversational COS analysis agent |
| `audience_profile` | 1 | OCEAN profile + Cialdini principle from an audience description |
| `analyze_framework` | 2 | Single framework (HAPE, Big Five, Strategic Clarity, Framing) |
| `analyze_platform` | 2 | Platform-specific optimization (13 platforms) |
| `analyze_quality` | 2 | 5-dimension quality assessment |
| `execute_template` | 2 | Run pre-built analysis templates |
| `analyze_persuasion` | 3 | Domain-specific persuasion analysis |
| `profile_agent` | 3 | Infer personality from writing samples |
| `analyze_content` | 5 | Full 4-framework analysis |
| `optimize_email_for_prospect` | 8 | **CRM composite** — audience profile + draft generation + persuasion + platform scoring in one call |
| `analyze_full_comms` | 10 | All 7 frameworks in parallel |
| `get_templates` | 0 | List available templates |
| `get_template_details` | 0 | Get template details |

### CRM integration — `optimize_email_for_prospect`

Built for Sales CRMs (Clarify, HubSpot, Salesforce, Pipedrive). Pass a Person/Account context, get back a draft + full scoring in a single call.

```python
optimize_email_for_prospect(
  audience_description="VP Eng at 200-person SaaS, viewed pricing 3x this week",
  intent="cold_outreach",
  name="Jamie Lee",
  title="VP Engineering",
  company="Acme Co",
  recent_signals=["pricing-page visits", "engineering team hiring"],
  sender_context="We cut CI costs by 40% for engineering teams.",
  # draft=None → COS generates one. Pass a draft to score+refine instead.
)
```

Returns: `{audience_profile, agent_profile?, draft, draft_was_generated, persuasion, platform, rewrites[], one_thing, cialdini_principle}`.

## Get an API Key

Sign up at [semalytics.com/cos](https://semalytics.com/cos) to get your API key and free starter credits.

## License

MIT
