Skip to content

calven-ai/calven

v1.0.0MIT

Connect AI agents to Calven and add sourced workflows for briefs, competitive analysis, and persona review.

GitHubOpen Website

Calven MCP

Bring the product marketing intelligence your team keeps in Calven into ChatGPT, Claude, Codex, Cursor, and other MCP clients.

1. Connect with MCP

MCP lets your AI assistant work with Calven without copy-pasting strategy, customer evidence, or competitive research between tools.

When your client asks for an MCP server URL, paste:

https://api.calven.ai/mcp

Choose OAuth and sign in to Calven. Your assistant gets the same workspace access and permissions you have.

If your client does not support OAuth, create a personal key in Calven → Settings → API & MCP. See the authentication guide for the key setup.

Command-line setup

claude mcp add --transport http calven https://api.calven.ai/mcp
codex mcp add calven --url https://api.calven.ai/mcp

2. Add the Calven plugin

MCP connects your assistant to Calven. The plugin adds repeatable workflows for the PMM work you do with that intelligence.

Install this repository in a client that supports Agent Plugins 1.0. The plugin connects the same Calven MCP server and adds three skills:

  • Workspace brief: turn strategy, market, customer, and win/loss evidence into a sourced brief.
  • Competitive brief: compare positioning, proof points, objections, deal evidence, and recent competitor moves.
  • Persona copy review: pressure-test copy against the buyer, stakeholder, and user personas in your workspace.

Direct MCP users get the same Calven data and actions. The plugin adds the workflow instructions. See plugin setup.

3. What your agents can do

Start with the full picture

Build a sourced brief for our payments product. Show our positioning, ICP,
customer themes, market shifts, and the evidence gaps I should resolve.

Prepare for a competitive deal

Compare us with Acme for an enterprise buyer. Give me where we win, where they
win, the proof points to use, and the objections our deal evidence supports.

Pull the voice of the customer into messaging

Show the strongest customer themes and quotes behind our onboarding message.
Keep each conclusion tied to its source.

Pressure-test a draft

Review this landing-page draft against our buyer personas. Rank the findings by
severity and show me the revision priorities before rewriting anything.

Your agents can also read positioning, messaging, ICP, product, and win/loss documents; inspect battle cards and competitor dossiers; query claims and product changes; and work with permitted CRM records. See the capability guide for the complete list.

Grounded in your workspace

  • Every request runs with your Calven identity, role, and workspace permissions.
  • Answers stay tied to the strategy and evidence your team keeps in Calven.
  • Missing evidence stays a gap. The skills tell agents not to replace it with model memory.
  • Persona review starts a review task. It does not publish or rewrite your copy without being asked.

Read data handling and security reporting for the public trust boundary.

Setup help

For developers and admins

This repository is the public distribution surface for Calven's hosted MCP server. The production server implementation remains private.

PathPurpose
server.jsonOfficial MCP Registry descriptor
plugin.jsonAgent Plugin manifest
mcp.jsonPortable MCP connection
skills/PMM workflow skills
docs/Authentication, capabilities, compatibility, trust, and operations
scripts/validate.mjsManifest, endpoint, credential, skill, and catalog checks

Run the public checks with:

npm ci
npm run validate

Documentation, compatibility results, examples, and skill improvements are welcome. Read CONTRIBUTING.md before opening a pull request.

Licensed under the MIT License. See LICENSE.