swallow-pricing-engine

Swallow Pricing Engine Plugin

A Claude Code plugin that connects to the Swallow insurance pricing engine via MCP. Build, validate, test, and publish insurance pricing models directly from Claude — then serve live quotes via API.

Why Swallow

Insurance carriers and MGAs spend weeks translating actuarial Excel models into production-ready systems. Engineering handoffs, manual rate filings, and dev sprints for every rate change slow time-to-market and introduce errors.

Swallow eliminates that cycle. Define your pricing logic as a JSON configuration — rating factors, decision rules, exclusions, endorsements, excesses, referrals — and Swallow runs it as a production API. No custom code, no deployment pipeline, no engineering tickets.

What you get with this plugin

• Build pricing models in natural language — describe your product and rating factors, Claude builds the Swallow config
• Convert Excel raters automatically — point Claude at a workbook, it traces the formulas and generates equivalent Swallow JSON
• Validate before you ship — deep schema validation catches structural problems before they reach production
• Test with real prices — run embedded test cases through the engine and get actual calculated premiums back
• Publish to a live API — deploy your model directly from Claude and get a public quote URL, ready to serve prices
• Analyse pricing surfaces — stress-test models with thousands of scenarios to find cliff edges, competitive gaps, and exposure

Free account

When you publish a project, Swallow creates a free account automatically using your email address. The free tier includes 100 quotes per month — enough to test, demo, and validate your pricing model end-to-end. For higher volumes, manage your account at swa.llow.io.

---

How to use this project

There are two ways to use this project — as a full plugin (Claude Code only) or as a standalone MCP server (Claude Chat, Claude Code, or any MCP client). The plugin includes the MCP server, so you don't need to set up both.

	Plugin	MCP Server
Platform	Claude Code	Claude Chat, Claude Code, any MCP client
MCP Tools	Yes	Yes
MCP Prompts	Yes	Yes
MCP Resource	Yes	Yes
Skills	Yes	No
Agents	Yes	No
Documentation	Yes (bundled)	Yes (via MCP)

---

Plugin (Claude Code)

The full plugin gives you everything: MCP tools, prompts, skills, agents, and bundled documentation.

Installation

From the marketplace

Add the marketplace and install the plugin:

/plugin marketplace add llow-group/swallow-claude-plugin
/plugin install swallow-pricing-engine@swallow-pricing-engine
/reload-plugins

Or add it manually to your Claude Code settings (~/.claude/settings.json):

{
  "extraKnownMarketplaces": {
    "swallow": {
      "source": "github",
      "repo": "llow-group/swallow-claude-plugin"
    }
  }
}

Then install:

/plugin install swallow-pricing-engine@swallow

You can choose your installation scope:

• User — available across all projects
• Project — shared with collaborators (stored in .claude/settings.json)
• Local — just for you in this repo

From the git repo (local development)

Clone the repo and load it directly:

git clone https://github.com/llow-group/swallow-claude-plugin.git
claude --plugin-dir ./swallow-claude-plugin

This is useful for development, testing, or customising the plugin before sharing.

Skills

Skill	Description
/swallow-pricing-engine:build-pricing-model	Guided workflow for building a Swallow config from a product description
/swallow-pricing-engine:excel-to-swallow	Convert an Excel workbook to Swallow JSON by tracing formulas
/swallow-pricing-engine:validate-project	Run deep schema validation on a project file
/swallow-pricing-engine:test-project	Run and debug embedded tests
/swallow-pricing-engine:swallow-docs	Load documentation, JSON schema, and agent rules into context

Agents

Agent	Role	When to use
swallow-actuary	Builds technically correct pricing models	Creating new models, fixing validation errors, adding steps/factors
swallow-analyst	Reviews models commercially	Understanding pricing behaviour, competitive positioning, recommending improvements

The actuary builds the model. The analyst tells you if the model makes commercial sense.

Both agents call docs_swallow_project to load the latest rules and constraints before working.

Usage examples

Build a new pricing model

@swallow-actuary Build a motor insurance model with age, vehicle value,
postcode, NCD, and conviction count as rating factors

Or via skill:

/swallow-pricing-engine:build-pricing-model