Skip to main content
Glama
deenesjakoruzh
berch-t

Kopern

by berch-t
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

@kopern/mcp-server

npm version kopern MCP server License: MIT

32 AI agent tools for Claude Code, Cursor, Windsurf, and any MCP client.

Build, test, grade, and deploy AI agents — all from your terminal or IDE.

Quick Start

Claude Code

claude mcp add kopern -- npx -y @kopern/mcp-server

Then set your API key:

export KOPERN_API_KEY=kpn_your_key_here

Manual Configuration

Add to your .mcp.json (project) or ~/.claude/settings.json (global):

{
  "mcpServers": {
    "kopern": {
      "command": "npx",
      "args": ["-y", "@kopern/mcp-server"],
      "env": {
        "KOPERN_API_KEY": "kpn_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "kopern": {
      "command": "npx",
      "args": ["-y", "@kopern/mcp-server"],
      "env": {
        "KOPERN_API_KEY": "kpn_your_key_here"
      }
    }
  }
}

Streamable HTTP (no install)

If your client supports HTTP MCP transport directly:

{
  "mcpServers": {
    "kopern": {
      "type": "http",
      "url": "https://kopern.ai/api/mcp/server",
      "headers": {
        "Authorization": "Bearer kpn_your_key_here"
      }
    }
  }
}

Related MCP server: Google Analytics MCP Server

Get Your API Key

  1. Go to kopern.ai and sign in

  2. Navigate to Settings > API Keys

  3. Click Generate API Key

  4. Copy the kpn_... key

Two key types:

  • User-level key — access to all 30 platform tools (agent CRUD, grading, templates, etc.)

  • Agent-bound key — access to all 32 tools including kopern_chat and kopern_agent_info

Tools (32)

Agent Management (8 tools)

Tool

Description

kopern_create_agent

Create a new agent with system prompt, model, skills, and tools

kopern_get_agent

Get full agent configuration and metadata

kopern_update_agent

Update agent system prompt, model, domain, or builtin tools

kopern_delete_agent

Permanently delete an agent

kopern_list_agents

List all your agents with scores and versions

kopern_chat

Send a message to an agent (with tool calling)

kopern_agent_info

Get agent metadata (agent-bound key only)

kopern_deploy_template

Deploy from 37 ready-made templates (BTP, Legal, E-commerce...)

Grading & Optimization (6 tools)

Tool

Description

kopern_grade_prompt

Grade a system prompt against inline test cases

kopern_create_grading_suite

Create a reusable test suite with cases

kopern_run_grading

Execute a grading suite, get scores + improvement notes

kopern_run_autoresearch

AutoTune — iterative prompt optimization (uses improvement notes)

kopern_get_grading_results

Get detailed results + improvement notes for a grading run

kopern_list_grading_runs

List score history for a suite

Teams & Pipelines (4 tools)

Tool

Description

kopern_create_team

Create multi-agent teams (parallel, sequential, conditional)

kopern_run_team

Execute a team with a prompt

kopern_create_pipeline

Create multi-step pipelines with input mapping

kopern_run_pipeline

Execute a pipeline sequentially

Connectors (7 tools)

Tool

Description

kopern_connect_widget

Deploy an embeddable chat widget

kopern_connect_telegram

Connect a Telegram bot

kopern_connect_whatsapp

Connect WhatsApp Business

kopern_connect_slack

Connect to Slack workspace

kopern_connect_webhook

Set up inbound/outbound webhooks

kopern_connect_email

Connect Gmail or Outlook

kopern_connect_calendar

Connect Google or Microsoft Calendar

Sessions & Memory (3 tools)

Tool

Description

kopern_list_sessions

List conversation sessions with metrics

kopern_get_session

Get full session details (events, tool calls, tokens)

kopern_manage_memory

Agent memory CRUD (remember, recall, forget, list)

Utilities (4 tools)

Tool

Description

kopern_list_templates

Browse 37 templates (28 general + 9 vertical)

kopern_compliance_report

Generate EU AI Act compliance report

kopern_get_usage

Token usage, cost, per-agent breakdown

kopern_export_agent

Export agent as portable JSON

kopern_import_agent

Import agent from JSON export

Examples

Create an agent from your terminal

> Use kopern_create_agent to create a customer support agent for my SaaS product

Grade a prompt

> Use kopern_grade_prompt to test my system prompt with these cases:
  - "What's your refund policy?" should mention "30-day guarantee"
  - "Can I cancel?" should be empathetic and provide steps

Deploy a template

> Use kopern_list_templates to show me business templates, then deploy the "restaurant" one

Grade and improve

> Run kopern_run_grading on my agent — it will return scores AND improvement notes.
  Then run kopern_run_autoresearch to optimize using those suggestions automatically.

Full workflow

> Create an agent, add a grading suite with 5 test cases, run grading,
  then run autoresearch to optimize the prompt to 90%+ score

Environment Variables

Variable

Required

Default

Description

KOPERN_API_KEY

Yes

—

Your Kopern API key (kpn_...)

KOPERN_URL

No

https://kopern.ai/api/mcp/server

Custom endpoint URL

Architecture

This package is a lightweight stdio-to-HTTP bridge. It receives JSON-RPC messages on stdin from your MCP client, forwards them to the Kopern Streamable HTTP endpoint, and returns responses on stdout.

Claude Code ──stdin──> @kopern/mcp-server ──HTTP──> kopern.ai/api/mcp/server
            <──stdout──                   <──JSON──

The Kopern server handles all MCP protocol methods (initialize, tools/list, tools/call, ping). Zero dependencies — just Node.js 18+ and fetch.

Links

License

MIT

Install Server
A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/berch-t/kopern'

If you have feedback or need assistance with the MCP directory API, please join our Discord server