@assemblyline-agents/attio 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Assembly Line contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @assemblyline-agents/attio
+
+Official Assembly Line connection plugin for Attio's hosted Streamable HTTP MCP
+server at `https://mcp.attio.com/mcp`. It exposes Attio's reviewed CRM,
+activity-intelligence, and reporting tools through user-authorized OAuth.
+
+## Setup
+
+Attio uses OAuth Authorization Code + PKCE and supports dynamic client
+registration. Register one public client for the Assembly Line deployment:
+
+```sh
+curl -X POST https://app.attio.com/oauth/register \
+  -H 'content-type: application/json' \
+  -d '{
+    "client_name": "Assembly Line",
+    "redirect_uris": ["https://YOUR-AGENT-HOST/assembly-line/connections/callback"],
+    "grant_types": ["authorization_code", "refresh_token"],
+    "response_types": ["code"],
+    "token_endpoint_auth_method": "none"
+  }'
+```
+
+Store the returned `client_id` as `ATTIO_MCP_CLIENT_ID`. Set
+`ATTIO_MCP_REDIRECT_URI` only when the registered callback differs from
+Assembly Line's normal connection callback URL. `ATTIO_MCP_URL` optionally
+overrides the hosted endpoint.
+
+Add the connection to an agent:
+
+```sh
+assembly-line add attio agent
+```
+
+The default connection is user-scoped: each person authorizes their own Attio
+account, and Attio enforces that person's workspace permissions.
+
+```ts
+import { defineAttioConnection } from "@assemblyline-agents/attio";
+
+export default defineAttioConnection({ access: "approval-required" });
+```
+
+When an agent should operate as one company service identity, authorize a
+dedicated Attio member once through the protected operator connection flow and
+store the grant at workspace scope:
+
+```ts
+export default defineAttioConnection({
+  subject: "workspace",
+  access: "approval-required"
+});
+```
+
+Do not let an arbitrary end user establish that shared grant. Preauthorize the
+dedicated account before opening the agent to users:
+
+```text
+GET /assembly-line/connections/authorize?connection=attio
+```
+
+That route requires the runtime's `agent-control` authentication. The returned
+URL opens Attio's consent screen; the callback stores the access and refresh
+tokens in Assembly Line's host-side grant store. User-scoped connections can
+also authorize lazily: the invoking run parks, sends the consent link to the
+user, and resumes after the callback.
+
+The reviewed MCP surface includes records and objects, lists and list entries,
+comments, notes, tasks, meetings, call recordings and transcripts, email
+search and content, workspace members and teams, basic reports, and read-only
+Particle SQL where the Attio plan supports it. It does not expose every REST
+administration operation, webhook management, file upload, or arbitrary schema
+mutation.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { type ConnectionAuthDefinition, type McpPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface AttioConnectionOptions extends Omit<McpPluginConnectionOptions, "auth"> {
+    auth?: ConnectionAuthDefinition | false;
+    /** Stable public OAuth client id registered with Attio. */
+    clientId?: string;
+    /** Override the runtime's normal /assembly-line/connections/callback URI. */
+    redirectUri?: string;
+}
+export declare function defineAttioConnection(options?: AttioConnectionOptions): import("@assemblyline-agents/core").McpHttpClientConnectionDefinition;
+export declare const assemblyLinePlugin: import("@assemblyline-agents/core").PluginModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,0BAA0B,EAAE,MAAM,CAAC;IACtF,IAAI,CAAC,EAAE,wBAAwB,GAAG,KAAK,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,yEAYzE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+import { connectionPluginMetadata, defineMcpPluginConnection, defineOAuthAuthorization, definePlugin } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("attio");
+export function defineAttioConnection(options = {}) {
+    const { auth, clientId, redirectUri, ...connection } = options;
+    return defineMcpPluginConnection(PLUGIN, {
+        ...connection,
+        auth: auth === false
+            ? false
+            : auth ?? attioOAuth({
+                ...(clientId ? { clientId } : {}),
+                ...(redirectUri ? { redirectUri } : {}),
+                ...(connection.url ? { mcpUrl: connection.url } : {})
+            })
+    });
+}
+export const assemblyLinePlugin = definePlugin({ connections: [PLUGIN] });
+function attioOAuth(input) {
+    return ({ env }) => {
+        const clientId = input.clientId?.trim() || env.ATTIO_MCP_CLIENT_ID?.trim();
+        if (!clientId) {
+            throw new Error("Attio OAuth requires ATTIO_MCP_CLIENT_ID or clientId.");
+        }
+        const redirectUri = input.redirectUri?.trim() || env.ATTIO_MCP_REDIRECT_URI?.trim();
+        const resource = input.mcpUrl?.trim() || env.ATTIO_MCP_URL?.trim() || PLUGIN.defaultUrl;
+        return defineOAuthAuthorization({
+            displayName: "Attio",
+            authorizeUrl: "https://app.attio.com/oidc/authorize",
+            tokenUrl: "https://app.attio.com/oidc/token",
+            clientId,
+            scopes: ["mcp", "offline_access", "openid"],
+            ...(redirectUri ? { redirectUri } : {}),
+            authorizationParams: { resource },
+            tokenParams: { resource },
+            pkce: true
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,YAAY,EAGb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAE,CAAC;AAUlD,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAC/D,OAAO,yBAAyB,CAAC,MAAM,EAAE;QACvC,GAAG,UAAU;QACb,IAAI,EAAE,IAAI,KAAK,KAAK;YAClB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC;gBACjB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;KACP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE1E,SAAS,UAAU,CAAC,KAInB;IACC,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;QAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,UAAW,CAAC;QACzF,OAAO,wBAAwB,CAAC;YAC9B,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,sCAAsC;YACpD,QAAQ,EAAE,kCAAkC;YAC5C,QAAQ;YACR,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,CAAC;YAC3C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,mBAAmB,EAAE,EAAE,QAAQ,EAAE;YACjC,WAAW,EAAE,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@assemblyline-agents/attio",
+  "version": "3.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@assemblyline-agents/core": "3.0.0"
+  },
+  "description": "Official Assembly Line connection plugin for Attio's hosted MCP server.",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/assembly-line.git",
+    "directory": "packages/attio"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/assembly-line/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/assembly-line#readme",
+  "author": "Assembly Line contributors",
+  "keywords": [
+    "assembly-line",
+    "ai",
+    "agents",
+    "attio",
+    "crm",
+    "mcp",
+    "oauth",
+    "connection",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}