cos-mcp 0.3.0

COS (Communication Optimization System) MCP server for Claude

COS MCP Server

MCP server for the Communication Optimization System (COS) — analyze content for engagement, personality fit, strategic clarity, and cognitive framing.

Quick Start

# 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

claude mcp add cos-mcp -- cos-mcp

Claude Desktop

Add to your claude_desktop_config.json:

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

Remote (zero-install)

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.

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 to get your API key and free starter credits.

License

MIT