@assemblyline-agents/grata 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,86 @@
+# @assemblyline-agents/grata
+
+Official Assembly Line connection plugin for Grata's hosted MCP server.
+
+The connection gives agents access to Grata private-market intelligence for
+company discovery, ownership, funding, transactions, buyers, executive
+contacts, and related research. It uses a per-user Grata seat through OAuth
+2.0, PKCE, and refreshable grants.
+
+## Install
+
+```sh
+npm install @assemblyline-agents/grata
+```
+
+## Configure OAuth
+
+Register an OAuth client with the `/register` endpoint in the Grata region the
+agent will use. Register the Assembly Line callback URL, normally:
+
+```text
+https://your-agent.example/assembly-line/connections/callback
+```
+
+Request `client_secret_post`, which matches Assembly Line's token exchange:
+
+```sh
+curl https://mcp.grata.com/register \
+  --header 'content-type: application/json' \
+  --data '{
+    "client_name": "Assembly Line",
+    "redirect_uris": ["https://your-agent.example/assembly-line/connections/callback"],
+    "grant_types": ["authorization_code", "refresh_token"],
+    "response_types": ["code"],
+    "token_endpoint_auth_method": "client_secret_post"
+  }'
+```
+
+Use `https://eu-mcp.grata.com/register` instead for the EU endpoint. Store the
+returned client id and secret without putting them in source control.
+
+Set the returned credentials on the runtime host:
+
+```sh
+GRATA_MCP_CLIENT_ID=...
+GRATA_MCP_CLIENT_SECRET=...
+```
+
+The plugin defaults to the US endpoint, `https://mcp.grata.com`. European
+users must select Grata's EU endpoint:
+
+```sh
+GRATA_MCP_URL=https://eu-mcp.grata.com/
+```
+
+Set `GRATA_MCP_REDIRECT_URI` only when the registered callback differs from
+the runtime's standard connection callback. Each user authorizes their own
+Grata account; credentials and refresh tokens stay in Assembly Line's
+host-side connection grant store.
+
+See [Grata's MCP setup guide](https://help.grata.com/en/articles/15279081-connecting-to-the-grata-mcp-server)
+for the current regional endpoints and seat requirements.
+
+## Usage
+
+```ts
+import { defineGrataConnection } from "@assemblyline-agents/grata";
+
+export default defineGrataConnection();
+```
+
+The plugin classifies reviewed search and retrieval tools as reads and
+write-like tools, including exports, as writes. Reviewed tools are enabled by
+default; developers can select `approval-required`, `read-only`, `autonomous`,
+or a custom access policy. Unclassified upstream tools remain unavailable.
+
+## Part of Assembly Line
+
+This package is part of [Assembly Line](https://github.com/jasonbadeaux/assembly-line),
+a vendor-neutral, filesystem-first framework for durable AI agents. See the
+developer documentation in [docs/developers/](https://github.com/jasonbadeaux/assembly-line/tree/main/docs/developers)
+for setup, agent authoring, and deployment guides.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type ConnectionAuthDefinition, type McpPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface GrataConnectionOptions extends Omit<McpPluginConnectionOptions, "auth"> {
+    auth?: ConnectionAuthDefinition | false;
+    /** OAuth client id returned by the selected Grata MCP region's registration endpoint. */
+    clientId?: string;
+    /** OAuth client secret returned with the client id. */
+    clientSecret?: string;
+    /** Override the runtime's normal /assembly-line/connections/callback URI. */
+    redirectUri?: string;
+}
+export declare function defineGrataConnection(options?: GrataConnectionOptions): 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,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,yEAazE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+import { connectionPluginMetadata, defineMcpPluginConnection, defineOAuthAuthorization, definePlugin } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("grata");
+export function defineGrataConnection(options = {}) {
+    const { auth, clientId, clientSecret, redirectUri, ...connection } = options;
+    return defineMcpPluginConnection(PLUGIN, {
+        ...connection,
+        auth: auth === false
+            ? false
+            : auth ?? grataOAuth({
+                ...(clientId ? { clientId } : {}),
+                ...(clientSecret ? { clientSecret } : {}),
+                ...(redirectUri ? { redirectUri } : {}),
+                ...(connection.url ? { mcpUrl: connection.url } : {})
+            })
+    });
+}
+export const assemblyLinePlugin = definePlugin({ connections: [PLUGIN] });
+function grataOAuth(input) {
+    return ({ env }) => {
+        const clientId = input.clientId?.trim() || env.GRATA_MCP_CLIENT_ID?.trim();
+        const clientSecret = input.clientSecret?.trim() || env.GRATA_MCP_CLIENT_SECRET?.trim();
+        if (!clientId || !clientSecret) {
+            throw new Error("Grata OAuth requires GRATA_MCP_CLIENT_ID and GRATA_MCP_CLIENT_SECRET, or clientId and clientSecret options.");
+        }
+        const redirectUri = input.redirectUri?.trim() || env.GRATA_MCP_REDIRECT_URI?.trim();
+        const resource = new URL(input.mcpUrl?.trim() || env.GRATA_MCP_URL?.trim() || PLUGIN.defaultUrl).toString();
+        return defineOAuthAuthorization({
+            displayName: "Grata",
+            authorizeUrl: new URL("/authorize", resource).toString(),
+            tokenUrl: new URL("/token", resource).toString(),
+            clientId,
+            clientSecret,
+            scopes: ["openid", "profile", "email", "offline_access"],
+            ...(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;AAYlD,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAC7E,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,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,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,KAKnB;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,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,CAAC;QACvF,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,6GAA6G,CAAC,CAAC;QACjI,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,UAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7G,OAAO,wBAAwB,CAAC;YAC9B,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,IAAI,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;YACxD,QAAQ,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;YAChD,QAAQ;YACR,YAAY;YACZ,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC;YACxD,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,48 @@
+{
+  "name": "@assemblyline-agents/grata",
+  "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 Grata hosted MCP connection plugin.",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/assembly-line.git",
+    "directory": "packages/grata"
+  },
+  "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",
+    "grata",
+    "private-markets",
+    "mcp",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}