Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

feat(registry): add Sent connection (#5249)

Colton Paddend34c52494511
diff --git a/apps/docs/lib/integrations/connection-setup.test.ts b/apps/docs/lib/integrations/connection-setup.test.ts
index 1d61f96e0..8ad279cfd 100644
--- a/apps/docs/lib/integrations/connection-setup.test.ts
+++ b/apps/docs/lib/integrations/connection-setup.test.ts
@@ -1,6 +1,6 @@
import { readFileSync } from "node:fs";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
import {
buildConnectionInstall,
@@ -9,6 +9,12 @@ import {
} from "./connection-setup";
import { getIntegration } from "./data";
import { integrationMarkdown } from "./discovery";
+import sentConnection from "../../registry/connections/sent";
+
+// Connect's runtime pulls in channel auth; these tests exercise only the authored approval policy.
+vi.mock("@vercel/connect/eve", () => ({
+ connect: () => ({ getToken: async () => ({ token: "" }) }),
+}));
describe("Browser Use connection setup", () => {
it("generates server-side header authentication without Connect", () => {
@@ -102,6 +108,35 @@ describe("FLORA connection setup", () => {
});
});
+describe("Sent connection setup", () => {
+ it("preserves the installed tool boundary in the gallery setup", () => {
+ const integration = getIntegration("sent")!;
+ const setup = buildConnectionSetup(integration);
+ const quickStart = integration.quickStart!;
+
+ expect(setup.authModes).toEqual(["user"]);
+ expect(setup.variants["mcp:user"]).toContain('url: "https://mcp.sent.dm/mcp"');
+ expect(setup.variants["mcp:user"]).toContain('auth: connect("sent")');
+ expect(setup.configureVariants["mcp:user"]).toContain(
+ "vercel connect create mcp.sent.dm --name sent",
+ );
+ expect(buildConnectionInstall(integration)).toContain("eve add connection/sent");
+ expect(quickStart).toContain("approval: ({ toolName }) =>");
+ expect(quickStart).toContain('? "user-approval"');
+ expect(quickStart).toContain(': "not-applicable"');
+
+ const { tools } = sentConnection;
+ if (!tools || !("allow" in tools)) {
+ throw new Error("Sent requires a tool allowlist.");
+ }
+ for (const toolName of tools.allow) {
+ expect(quickStart).toContain(`"${toolName}"`);
+ }
+
+ expect(integrationMarkdown(integration)).toContain(quickStart);
+ });
+});
+
describe("Neon connection setup", () => {
it("generates the registry install and Vercel Connect configuration", () => {
const integration = getIntegration("neon")!;
diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.ts
index 0abd6210f..e5a9af943 100644
--- a/apps/docs/lib/integrations/data.ts
+++ b/apps/docs/lib/integrations/data.ts
@@ -2079,6 +2079,74 @@ const connectionPresentations: Record<string, ConnectionPresentation> = {
authModes: ["user", "app"],
relatedResources: [softwareFactoryGuide],
},
+ sent: {
+ logo: "sent",
+ docsHref: "https://docs.sent.dm/start/llm-docs/mcp-server",
+ keywords: [
+ "mcp",
+ "sms",
+ "whatsapp",
+ "rcs",
+ "business messaging",
+ "deliverability",
+ "oauth",
+ "connect",
+ ],
+ authModes: ["user"],
+ connectors: { user: { service: "mcp.sent.dm", name: "sent" } },
+ quickStart: `Create \`agent/connections/sent.ts\`. The connection name is derived from the filename:
+
+\`\`\`ts
+// agent/connections/sent.ts
+import { connect } from "@vercel/connect/eve";
+import { defineMcpClientConnection } from "eve/connections";
+
+const APPROVAL_REQUIRED = new Set([
+ "messages.send",
+ "contacts.create_many",
+ "contacts.delete",
+ "templates.delete",
+]);
+
+export default defineMcpClientConnection({
+ url: "https://mcp.sent.dm/mcp",
+ description:
+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",
+ auth: connect("sent"),
+ tools: {
+ allow: [
+ "account.get",
+ "balance.get",
+ "contacts.create_many",
+ "contacts.delete",
+ "contacts.get",
+ "contacts.list",
+ "contacts.message_summary",
+ "dashboard.contacts",
+ "dashboard.deliverability",
+ "dashboard.messages_sent",
+ "messages.activities.list",
+ "messages.get",
+ "messages.send",
+ "numbers.lookup",
+ "onboarding.status",
+ "templates.delete",
+ "templates.get",
+ "templates.get_by_name",
+ "templates.list",
+ ],
+ },
+ approval: ({ toolName }) =>
+ APPROVAL_REQUIRED.has(toolName.split("__").pop() ?? toolName)
+ ? "user-approval"
+ : "not-applicable",
+});
+\`\`\`
+
+The allowlist limits the connection to the reviewed Sent tools. eve requires user approval before sending a message, creating or deleting contacts, or deleting a template.`,
+ configureNote:
+ "Sends real SMS, WhatsApp, and RCS messages. Sending messages, creating or deleting contacts, and deleting templates require approval; Sender Profile, compliance, and feedback tools aren't exposed. Revoke access by deactivating the connection key in Sent Dashboard → API Keys.",
+ },
notion: {
logo: "notion",
docsHref: "/docs/connections",
diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsx
index c15547edd..748243b6c 100644
--- a/apps/docs/lib/integrations/logos.tsx
+++ b/apps/docs/lib/integrations/logos.tsx
@@ -50,6 +50,16 @@ const eveLogo = (props: LogoProps) => (
</svg>
);
+const sentLogo = (props: LogoProps) => (
+ <svg viewBox="0 0 188 188" xmlns="http://www.w3.org/2000/svg" {...props}>
+ <rect fill="#030712" height="188" rx="32" width="188" />
+ <g fill="#fff" transform="translate(0 6)">
+ <path d="M76.9 46.17c-3.09-1.17-4.65-4.62-3.48-7.71L84.97 7.87c1.17-3.09 4.62-4.65 7.7-3.48l89.46 33.83c3.09 1.17 4.65 4.62 3.48 7.71L151.8 135.46c-1.17 3.09-4.62 4.65-7.7 3.48l-30.56-11.56c-3.09-1.17-4.65-4.62-3.48-7.71l18.03-47.75c1.17-3.09-.39-6.55-3.48-7.72L76.9 46.17z" />
+ <path d="M3.87 78.84C.78 77.67-.78 74.22.39 71.13L11.94 40.54c1.17-3.09 4.62-4.65 7.7-3.48l89.46 33.84c3.09 1.17 4.65 4.62 3.48 7.71l-33.81 89.52c-1.17 3.09-4.62 4.65-7.7 3.48L40.5 160.05c-3.09-1.17-4.65-4.62-3.48-7.71l18.03-47.75c1.17-3.09-.39-6.54-3.48-7.71L3.87 78.84z" />
+ </g>
+ </svg>
+);
+
export const webLogo = (props: LogoProps) => (
<svg fill="none" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" {...props}>
<circle cx="12" cy="12" r="9" stroke="currentColor" strokeWidth="1.5" />
@@ -892,6 +902,7 @@ export const logos = {
agentcard: agentcardLogo,
vercel: vercelLogo,
linear: linearLogo,
+ sent: sentLogo,
context: contextLogo,
notion: notionLogo,
datadog: datadogLogo,
diff --git a/apps/docs/lib/integrations/sent-registry.test.ts b/apps/docs/lib/integrations/sent-registry.test.ts
new file mode 100644
index 000000000..02693e1d6
--- /dev/null
+++ b/apps/docs/lib/integrations/sent-registry.test.ts
@@ -0,0 +1,55 @@
+import { describe, expect, it, vi } from "vitest";
+
+import sentConnection from "../../registry/connections/sent";
+
+// Connect's runtime pulls in channel auth; these tests exercise only the authored approval policy.
+vi.mock("@vercel/connect/eve", () => ({
+ connect: () => ({ getToken: async () => ({ token: "" }) }),
+}));
+
+const ALLOWED_TOOLS = [
+ "account.get",
+ "balance.get",
+ "contacts.create_many",
+ "contacts.delete",
+ "contacts.get",
+ "contacts.list",
+ "contacts.message_summary",
+ "dashboard.contacts",
+ "dashboard.deliverability",
+ "dashboard.messages_sent",
+ "messages.activities.list",
+ "messages.get",
+ "messages.send",
+ "numbers.lookup",
+ "onboarding.status",
+ "templates.delete",
+ "templates.get",
+ "templates.get_by_name",
+ "templates.list",
+] as const;
+
+const APPROVAL_REQUIRED = new Set([
+ "messages.send",
+ "contacts.create_many",
+ "contacts.delete",
+ "templates.delete",
+]);
+
+describe("Sent registry connection", () => {
+ it("keeps the reviewed tool and approval boundary", () => {
+ const { tools, approval } = sentConnection;
+ if (!tools || !("allow" in tools) || typeof approval !== "function") {
+ throw new Error("Sent requires a tool allowlist and per-tool approval policy.");
+ }
+ expect(tools.allow).toEqual(ALLOWED_TOOLS);
+
+ for (const toolName of ALLOWED_TOOLS) {
+ expect(approval({ toolName: `sent__${toolName}` } as never)).toBe(
+ APPROVAL_REQUIRED.has(toolName) ? "user-approval" : "not-applicable",
+ );
+ }
+
+ expect(approval({ toolName: "sent__sender_profiles.create" } as never)).toBe("not-applicable");
+ });
+});
diff --git a/apps/docs/registry.json b/apps/docs/registry.json
index 3f365aa07..102687dc0 100644
--- a/apps/docs/registry.json
+++ b/apps/docs/registry.json
@@ -632,6 +632,39 @@
}
]
},
+ {
+ "name": "connection/sent",
+ "type": "registry:item",
+ "title": "Sent",
+ "description": "Send and track SMS, WhatsApp, and RCS through Sent's MCP server.",
+ "meta": {
+ "eve": {
+ "setup": {
+ "command": "eve",
+ "package": "eve",
+ "bin": "eve",
+ "args": [
+ "integration",
+ "connect",
+ "sent",
+ "mcp.sent.dm",
+ "sent"
+ ]
+ },
+ "requires": ">=0.51.1"
+ }
+ },
+ "dependencies": [
+ "@vercel/connect"
+ ],
+ "files": [
+ {
+ "path": "registry/connections/sent.ts",
+ "type": "registry:file",
+ "target": "agent/connections/sent.ts"
+ }
+ ]
+ },
{
"name": "connection/notion",
"type": "registry:item",
diff --git a/apps/docs/registry/connections/sent.ts b/apps/docs/registry/connections/sent.ts
new file mode 100644
index 000000000..bf7bbe4ec
--- /dev/null
+++ b/apps/docs/registry/connections/sent.ts
@@ -0,0 +1,43 @@
+import { connect } from "@vercel/connect/eve";
+import { defineMcpClientConnection } from "eve/connections";
+
+const APPROVAL_REQUIRED = new Set([
+ "messages.send",
+ "contacts.create_many",
+ "contacts.delete",
+ "templates.delete",
+]);
+
+export default defineMcpClientConnection({
+ url: "https://mcp.sent.dm/mcp",
+ description:
+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",
+ auth: connect("sent"),
+ tools: {
+ allow: [
+ "account.get",
+ "balance.get",
+ "contacts.create_many",
+ "contacts.delete",
+ "contacts.get",
+ "contacts.list",
+ "contacts.message_summary",
+ "dashboard.contacts",
+ "dashboard.deliverability",
+ "dashboard.messages_sent",
+ "messages.activities.list",
+ "messages.get",
+ "messages.send",
+ "numbers.lookup",
+ "onboarding.status",
+ "templates.delete",
+ "templates.get",
+ "templates.get_by_name",
+ "templates.list",
+ ],
+ },
+ approval: ({ toolName }) =>
+ APPROVAL_REQUIRED.has(toolName.split("__").pop() ?? toolName)
+ ? "user-approval"
+ : "not-applicable",
+});
diff --git a/apps/docs/scripts/validate-connection-registry.ts b/apps/docs/scripts/validate-connection-registry.ts
index 4b2db71af..658915334 100644
--- a/apps/docs/scripts/validate-connection-registry.ts
+++ b/apps/docs/scripts/validate-connection-registry.ts
@@ -52,6 +52,7 @@ const CONNECT_SERVICES: Readonly<Record<string, string>> = {
agentcard: "mcp.agentcard.sh/mcp",
vercel: "vercel",
linear: "mcp.linear.app",
+ sent: "mcp.sent.dm",
notion: "mcp.notion.com",
datadog: "mcp.datadoghq.com",
honeycomb: "mcp.honeycomb.io",
diff --git a/apps/docs/vitest.config.ts b/apps/docs/vitest.config.ts
index cc7a8facb..2eda4f055 100644
--- a/apps/docs/vitest.config.ts
+++ b/apps/docs/vitest.config.ts
@@ -1,6 +1,18 @@
import { defineConfig } from "vitest/config";
export default defineConfig({
+ resolve: {
+ alias: [
+ {
+ find: /^eve\/(connections|tools\/approval)$/,
+ replacement: new URL("../../packages/eve/src/public/$1/index.ts", import.meta.url).pathname,
+ },
+ {
+ find: /^#(.+)\.js$/,
+ replacement: new URL("../../packages/eve/src/$1.ts", import.meta.url).pathname,
+ },
+ ],
+ },
test: {
include: ["lib/**/*.test.ts"],
},
diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.ts
index ad5a0d91f..242770e5b 100644
--- a/packages/eve-catalog/src/index.ts
+++ b/packages/eve-catalog/src/index.ts
@@ -427,6 +427,18 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
mcp: { url: "https://mcp.linear.app/mcp" },
},
},
+ {
+ slug: "sent",
+ name: "Sent",
+ kind: "connection",
+ tagline: "Send and track SMS, WhatsApp, and RCS through Sent's MCP server.",
+ surfaces: { scaffoldable: false, registry: true, gallery: true },
+ connection: {
+ description:
+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",
+ mcp: { url: "https://mcp.sent.dm/mcp" },
+ },
+ },
{
slug: "notion",
name: "Notion",