Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,16 +10,25 @@
{
"name": "corsair",
"source": "./plugins/corsair",
"description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.",
"description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.",
"category": "productivity",
"tags": ["integrations", "automation", "mcp"]
"tags": [
"integrations",
"automation",
"mcp"
]
},
{
"name": "corsair-sdk",
"source": "./plugins/corsair-sdk",
"description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.",
"category": "development",
"tags": ["integrations", "oauth", "webhooks", "sdk"]
"tags": [
"integrations",
"oauth",
"webhooks",
"sdk"
]
}
]
}
2 changes: 1 addition & 1 deletion .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
{
"name": "corsair",
"source": "./plugins/corsair",
"description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.",
"description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.",
"logo": "https://corsair.dev/corsair-logo.png",
"category": "productivity"
},
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Plugins that install [Corsair](https://corsair.dev) into AI clients. One tree se

| Plugin | For | Contains |
| --- | --- | --- |
| [`corsair`](plugins/corsair) | People using their connected apps from an agent | The Corsair MCP server and five skills for using it |
| [`corsair`](plugins/corsair) | People working in Corsair's PM and CRM, or their connected apps, from an agent | The Corsair MCP server and six skills for using it |
| [`corsair-sdk`](plugins/corsair-sdk) | Developers adding the Corsair SDK to an app | The `corsair` setup skill and the Corsair docs MCP server |

## Install
Expand Down
2 changes: 1 addition & 1 deletion gemini-extension.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "corsair",
"version": "0.1.5",
"version": "0.1.6",
"description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.",
"mcpServers": {
"corsair": {
Expand Down
17 changes: 14 additions & 3 deletions plugins/corsair-sdk/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "corsair-sdk",
"version": "0.1.1",
"version": "0.1.2",
"displayName": "Corsair SDK",
"description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.",
"author": {
Expand All @@ -13,6 +13,17 @@
"license": "Apache-2.0",
"privacyPolicyUrl": "https://corsair.dev/privacy-policy",
"termsOfServiceUrl": "https://corsair.dev/terms-of-service",
"keywords": ["corsair", "integrations", "oauth", "webhooks", "sdk"],
"mcpServers": "./mcp.json"
"keywords": [
"corsair",
"integrations",
"oauth",
"webhooks",
"sdk"
],
"mcpServers": {
"corsair-docs": {
"type": "http",
"url": "https://docs.corsair.dev/mcp"
}
}
}
10 changes: 8 additions & 2 deletions plugins/corsair-sdk/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "corsair-sdk",
"version": "0.1.1",
"version": "0.1.2",
"description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.",
"author": {
"name": "Corsair",
Expand All @@ -11,7 +11,13 @@
"homepage": "https://docs.corsair.dev",
"repository": "https://github.com/corsairdev/agent-plugins",
"license": "Apache-2.0",
"keywords": ["corsair", "integrations", "oauth", "webhooks", "sdk"],
"keywords": [
"corsair",
"integrations",
"oauth",
"webhooks",
"sdk"
],
"extensions": {
"com.openai": {
"interface": {
Expand Down
18 changes: 14 additions & 4 deletions plugins/corsair/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{
"name": "corsair",
"version": "0.1.5",
"version": "0.1.6",
"displayName": "Corsair",
"icon": "./assets/icon.png",
"description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.",
"description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.",
"author": {
"name": "Corsair",
"email": "primary@corsair.dev",
Expand All @@ -16,6 +16,16 @@
"license": "Apache-2.0",
"privacyPolicyUrl": "https://corsair.dev/privacy-policy",
"termsOfServiceUrl": "https://corsair.dev/terms-of-service",
"keywords": ["corsair", "integrations", "automation", "mcp"],
"mcpServers": "./mcp.json"
"keywords": [
"corsair",
"integrations",
"automation",
"mcp"
],
"mcpServers": {
"corsair": {
"type": "http",
"url": "https://mcp.corsair.dev/mcp"
}
}
}
5 changes: 3 additions & 2 deletions plugins/corsair/README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# Corsair

Use the apps you've connected in [Corsair](https://corsair.dev) from your agent: read and act on them, search synced data, and set up automations that run on app events or a schedule.
Work in [Corsair](https://corsair.dev) from your agent: track issues in Corsair's PM, keep people, companies and deals in its CRM, use the other apps you've connected, search across all of them, and set up automations that run on app events or a schedule.

The plugin adds the Corsair MCP server, `https://mcp.corsair.dev/mcp`, and five skills:
The plugin adds the Corsair MCP server, `https://mcp.corsair.dev/mcp`, and six skills:

| Skill | Covers |
| --- | --- |
| `corsair-workspace` | Corsair's own PM and CRM: filing and updating issues, and keeping people, companies, deals, notes and tasks |
| `corsair-connect-apps` | Finding an app, handing over its sign-in link or pointing to the Connect button on Corsair's card, and confirming the connection |
| `corsair-data` | When to search synced data, read an app live, make a change or wait on a long job; what apps on Corsair's account cost; when to send Corsair feedback |
| `corsair-automations` | Building automations from plain English or exact steps, then checking their runs |
Expand Down
16 changes: 12 additions & 4 deletions plugins/corsair/plugin.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "corsair",
"version": "0.1.5",
"description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.",
"version": "0.1.6",
"description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.",
"author": {
"name": "Corsair",
"email": "primary@corsair.dev",
Expand All @@ -11,7 +11,12 @@
"homepage": "https://corsair.dev",
"repository": "https://github.com/corsairdev/agent-plugins",
"license": "Apache-2.0",
"keywords": ["corsair", "integrations", "automation", "mcp"],
"keywords": [
"corsair",
"integrations",
"automation",
"mcp"
],
"extensions": {
"com.openai": {
"onboardingSkill": "./skills/corsair-connect-apps/SKILL.md",
Expand All @@ -20,7 +25,10 @@
"shortDescription": "Use your connected apps and automate across them",
"developerName": "Corsair",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"capabilities": [
"Read",
"Write"
],
"websiteURL": "https://corsair.dev",
"privacyPolicyURL": "https://corsair.dev/privacy-policy",
"termsOfServiceURL": "https://corsair.dev/terms-of-service",
Expand Down
2 changes: 1 addition & 1 deletion plugins/corsair/server.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "dev.corsair/mcp",
"title": "Corsair",
"description": "Use your connected apps from your agent: search synced data, act in apps and set up automations.",
"version": "0.1.5",
"version": "0.1.6",
"websiteUrl": "https://corsair.dev",
"repository": {
"url": "https://github.com/corsairdev/agent-plugins",
Expand Down
2 changes: 1 addition & 1 deletion plugins/corsair/skills/corsair-connect-apps/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: Use when the user wants to use an app through Corsair that isn't co

# Connect an app through Corsair

Corsair can reach the user's apps (Gmail, Slack, GitHub, Linear and hundreds more). Most need the user to sign in first. Your part is to find the app, get the sign-in link, hand it over, and confirm it worked. You never sign in on the user's behalf.
Corsair's own PM and CRM are ready on every link and need no sign-in (see the corsair-workspace skill). Corsair can also reach the user's other apps (Gmail, Slack, GitHub, Linear and hundreds more); most of those need the user to sign in first. Your part is to find the app, get the sign-in link, hand it over, and confirm it worked. You never sign in on the user's behalf.

## Steps

Expand Down
4 changes: 2 additions & 2 deletions plugins/corsair/skills/corsair-data/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: corsair-data
description: Use when answering a question from the user's connected apps through Corsair (find a message, summarize recent emails, check a calendar, look up an issue) or doing something in an app right now (send, create, update). Explains when to search synced data with search, read live with read_data, make changes with run_script, wait on long jobs with get_job, what apps on Corsair's account cost, and when to send submit_feedback.
description: Use when answering a question from the user's Corsair workspace or connected apps (find a message, summarize recent emails, check a calendar, look up an issue, a deal or a note in Corsair's PM or CRM) or doing something in an app right now (send, create, update). Explains when to search synced data with search, read live with read_data, make changes with run_script, wait on long jobs with get_job, what apps on Corsair's account cost, and when to send submit_feedback.
---

# Read and act on connected apps
Expand All @@ -9,7 +9,7 @@ Three Corsair tools reach the user's data:

| | `search` | `read_data` | `run_script` |
| --- | --- | --- | --- |
| Reads | Data Corsair has already synced (Slack messages, Gmail, Calendar and so on) | The app's live API | The app's live API |
| Reads | Corsair's own PM and CRM, and data Corsair has already synced from connected apps (Slack messages, Gmail, Calendar and so on) | The app's live API | The app's live API |
| Writes | No | No: the script stops at the first write, before that write runs | Yes: send, create, update, delete |
| Best for | Finding things ("what did Sarah say about the refund?") | Current state and exact lists | Any change |

Expand Down
56 changes: 56 additions & 0 deletions plugins/corsair/skills/corsair-workspace/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
name: corsair-workspace
description: Use when the user wants to track work or customers in Corsair: file, update or list issues and projects in Corsair's PM, or add and update people, companies, deals, notes and tasks in Corsair's CRM. Gives the action names and the usual lookups for both.
---

# Corsair's PM and CRM

Every Corsair link comes with two apps of Corsair's own. Their data lives in Corsair, so they work without any other app connected.

- **PM** (`pm`): teams, projects, issues with a status, priority, assignee, labels and a due date, plus comments.
- **CRM** (`crm`): people, companies and deals. A deal has a stage (Lead, In Progress, Won, Lost), a value, an owner and linked people and company. Any record can have notes and tasks.

Find what's there with `search` first ("what's open for the Kestrel pilot?" finds the deal, its notes and tasks, and the PM issues that name it). Use `read_data` for complete lists and `run_script` for changes, as the corsair-data skill explains.

## PM

| To | Action |
| --- | --- |
| Look up teams, states, people, labels, projects | `pm.db.teams.search`, `pm.db.workflowStates.search`, `pm.db.users.search`, `pm.db.issueLabels.search`, `pm.db.projects.search` |
| List or find issues | `pm.db.issues.search` (filter on `title`, `stateId`, `assigneeId`, `projectId`, `dueDate`) |
| File an issue | `pm.api.issues.create`: `title`, and optionally `stateId`, `priority` (1 urgent, 2 high, 3 medium, 4 low), `assigneeId`, `dueDate` (YYYY-MM-DD), `projectId`, `labelIds` |
| Change an issue | `pm.api.issues.update` with the issue's `id` |
| Comment | `pm.api.comments.create` |

Ids come from the lookups, never from names: look up the state, label, project and member first, in the same script.

```js
const [states, labels, projects, users] = await Promise.all([
corsair.pm.db.workflowStates.search({ limit: 50 }),
corsair.pm.db.issueLabels.search({ limit: 50 }),
corsair.pm.db.projects.search({ limit: 50 }),
corsair.pm.db.users.search({ limit: 50 }),
]);
const todo = states.find((s) => s.name === 'Todo');
const bug = labels.find((l) => l.name === 'Bug');
const relaunch = projects.find((p) => p.name === 'Website relaunch');
return await corsair.pm.api.issues.create({
title: 'Checkout button does nothing in Safari',
stateId: todo?.id, priority: 1, labelIds: bug ? [bug.id] : [], projectId: relaunch?.id,
assigneeId: users[0]?.id, dueDate: '2026-11-21',
});
```

## CRM

| To | Action |
| --- | --- |
| Find records | `crm.api.records.query` with `object` (`people`, `companies`, `deals`), and `q` for text or `filter` such as `{ stage: 'Lead' }` |
| Add a record | `crm.api.records.create` with `object` and `values` (attribute slugs from `crm.api.attributes.list`) |
| Change a record | `crm.api.records.patch` with `object`, `record_id`, `values`; a deal's stage takes the stage's title |
| Notes | `crm.api.notes.create` with `record_id`, `title`, `content` |
| Tasks | `crm.api.tasks.create` with `content`, `deadline`, `linked_records` |

A record's values come back as lists of dated values; the current one has `active_until: null`.

Moving a deal to Won or Lost, or deleting anything, changes the user's records: say what you'll change and do it only when they asked for it.
16 changes: 15 additions & 1 deletion scripts/check.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,20 @@ for (const { name } of entries.claude) {
fail(`${market} marketplace: ${name} description differs from ${dir}/plugin.json`);
}
}
if (claude.mcpServers !== "./mcp.json") fail(`${dir}/.claude-plugin/plugin.json: mcpServers should be "./mcp.json"`);
// Claude's directory refuses the Agent Plugins MCP file ($schema, type
// streamable-http), so the Claude manifest declares its servers inline with
// type http, one per server in mcp.json, at the same URL.
const portableServers = json(`${dir}/mcp.json`)?.mcpServers ?? {};
const claudeServers = claude.mcpServers;
if (typeof claudeServers !== "object" || claudeServers === null) {
fail(`${dir}/.claude-plugin/plugin.json: mcpServers should be an inline object`);
} else {
for (const [name, server] of Object.entries(portableServers)) {
const c = claudeServers[name];
if (!c || c.type !== "http" || c.url !== server.url) fail(`${dir}/.claude-plugin/plugin.json: mcpServers.${name} should be {type: "http", url: "${server.url}"}`);
}
for (const name of Object.keys(claudeServers)) if (!portableServers[name]) fail(`${dir}/.claude-plugin/plugin.json: mcpServers.${name} is not in mcp.json`);
}

const openai = portable.extensions?.["com.openai"] ?? {};
for (const rel of [openai.onboardingSkill, openai.interface?.composerIcon, openai.interface?.logo]) {
Expand Down Expand Up @@ -99,6 +112,7 @@ for (const { name } of entries.claude) {
const corsair = json("plugins/corsair/plugin.json");
const urls = {
"plugins/corsair/mcp.json": json("plugins/corsair/mcp.json")?.mcpServers?.corsair?.url,
"plugins/corsair/.claude-plugin/plugin.json": json("plugins/corsair/.claude-plugin/plugin.json")?.mcpServers?.corsair?.url,
"gemini-extension.json": json("gemini-extension.json")?.mcpServers?.corsair?.httpUrl,
"plugins/corsair/server.json": json("plugins/corsair/server.json")?.remotes?.[0]?.url,
};
Expand Down
Loading