@reneturcios/agencyfind 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Rene Turcios
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,83 @@
1
- # Temporary Holding Version
1
+ # agencyfind
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Find a licensed insurance agency, or an insurance MCP server, from your own machine's tool list. agencyfind is a local forwarding client for the hosted DouxProcess MCP service: it answers `tools/list` locally from the captured tool definitions and forwards every lookup to DouxProcess, returning the answers exactly as the service sends them back.
4
+
5
+ The built surface covers a licensed-agency directory search by line of insurance and US state, a search over the free insurance MCP server directory, a full read of one listed server, and an information read that explains how an agency gets its own MCP server. Nothing is cached, stored or computed locally — the package is a pipe, not an agency or a directory.
6
+
7
+ This is a labelled subset rebuild: the upstream capture enumerates five tools, and four are built here. The remaining one, `request_quote`, sends a person's name, an email or phone, coverage details and a consent flag to the agency that person chose, whose licensed staff reply — a send-shaped PII lead-routing tool — so it is omitted — not registered, not served in `tools/list`, and not available on the CLI.
8
+
9
+ ## The tools
10
+
11
+ - **`find_agencies`** — Find licensed insurance agencies that write a given line of insurance in a US state, best match first, with licence number, lines, states, phone, hours and online quote link. `line` and `state` are required.
12
+ - **`search_servers`** — Search the free insurance MCP directory by line, state, audience or words. Each result says whether the server answered its last live check, its tool count and its address. No parameters are required.
13
+ - **`get_server`** — Everything about one listed server: its tools from the last live check, its address and how to add it to common clients. `slug` is required.
14
+ - **`build_my_server`** — How an insurance agency gets its own MCP server, free: the builder link and what it makes. It builds nothing itself and takes no input.
15
+
16
+ ## Install and run
17
+
18
+ As an MCP server via npm:
19
+
20
+ ```bash
21
+ npx -y @reneturcios/agencyfind mcp
22
+ ```
23
+
24
+ MCP client configuration:
25
+
26
+ ```json
27
+ {
28
+ "mcpServers": {
29
+ "agencyfind": {
30
+ "command": "npx",
31
+ "args": ["-y", "@reneturcios/agencyfind", "mcp"]
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ As a container:
38
+
39
+ ```bash
40
+ docker run -i ghcr.io/cloudcorprecords/agencyfind
41
+ docker run --rm ghcr.io/cloudcorprecords/agencyfind get_server '{"slug":"acme"}'
42
+ ```
43
+
44
+ ## CLI
45
+
46
+ One binary serves both the command line and the MCP server. Each tool is a subcommand taking a single JSON string with that tool's arguments:
47
+
48
+ ```bash
49
+ agencyfind find_agencies '{"line":"general-liability","state":"CA"}'
50
+ agencyfind search_servers '{"line":"home","state":"CA"}'
51
+ agencyfind get_server '{"slug":"acme"}'
52
+ agencyfind build_my_server '{}'
53
+ agencyfind --version
54
+ ```
55
+
56
+ Exit codes: `0` when the forwarded call succeeds, `1` when the upstream result is an error, and `2` for usage problems such as an unknown subcommand or a malformed JSON argument.
57
+
58
+ ## Configuration
59
+
60
+ - `DOUXAGENCIES_MCP_URL` — Overrides the upstream endpoint. The default is the pinned hosted endpoint, `https://douxprocess.com/mcp`. (The override variable is a reconstruction added by this rebuild.)
61
+
62
+ The upstream registry record declares no headers, so no authentication header is ever sent; the tool surface was captured keyless.
63
+
64
+ Upstream failures — a JSON-RPC error from the service, a non-2xx response, an unreadable body, or a request that fails outright — are reported to the caller as an error result whose text starts with `agencyfind error:`.
65
+
66
+ ## How forwarding works
67
+
68
+ The first forwarded call opens a session: an `initialize` request (protocol version `2025-03-26`), followed by a `notifications/initialized` notification, then the `tools/call` itself. If the service answers the initialize request with an `Mcp-Session-Id` header, that value is carried on every later request, and the open session is reused for the rest of the process. Replies are accepted either as plain JSON or as server-sent events. Successful results pass through verbatim, including any `isError` flag and any extra fields the service includes.
69
+
70
+ ## Development
71
+
72
+ ```bash
73
+ npm install
74
+ npm run build # tsc -> dist/ (dist/cli.js is the bin)
75
+ npm test # tsx --test test/*.test.ts — stubbed upstream, no network
76
+ npm run dev # run the CLI from source
77
+ ```
78
+
79
+ The test suite checks the served tool list against the captured surface, asserts the omitted `request_quote` tool is absent at the registry, MCP and CLI levels, exercises the session handshake and its reuse, verifies that no `Authorization` header is ever sent, and verifies that arguments go upstream untouched and results come back untouched.
80
+
81
+ ## License
82
+
83
+ MIT — see `LICENSE`. Copyright (c) 2026 Rene Turcios.
package/dist/cli.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/cli.js ADDED
@@ -0,0 +1,79 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * agencyfind CLI.
4
+ *
5
+ * agencyfind <tool> '<json-args>'
6
+ * agencyfind mcp
7
+ * agencyfind --version
8
+ *
9
+ * <tool> is one of the 4 built forwarded tools. Each
10
+ * tool subcommand takes a single JSON argument string
11
+ * holding that tool's arguments, forwards the call the
12
+ * same way the MCP path does, and prints the forwarded
13
+ * result content. Exit codes: 0 success, 1 on an
14
+ * isError result, 2 usage error.
15
+ */
16
+ import { callTool, TOOL_NAMES, VERSION } from "./forward.js";
17
+ function usage() {
18
+ console.error(`Usage:
19
+ agencyfind <tool> '<json-args>' one of: ${TOOL_NAMES.join(", ")}
20
+ agencyfind mcp
21
+ agencyfind --version`);
22
+ process.exit(2);
23
+ }
24
+ function firstText(result) {
25
+ const content = result.content;
26
+ if (Array.isArray(content)) {
27
+ for (const item of content) {
28
+ if (item !== null &&
29
+ typeof item === "object" &&
30
+ item.type === "text" &&
31
+ typeof item.text === "string") {
32
+ return item.text;
33
+ }
34
+ }
35
+ }
36
+ return typeof content === "string" ? content : JSON.stringify(content);
37
+ }
38
+ async function main() {
39
+ const [cmd, ...rest] = process.argv.slice(2);
40
+ if (cmd === "--version" || cmd === "-v") {
41
+ console.log(VERSION);
42
+ return;
43
+ }
44
+ if (cmd === "mcp") {
45
+ if (rest.length !== 0)
46
+ usage();
47
+ const { startMcpServer } = await import("./mcp.js");
48
+ await startMcpServer();
49
+ return;
50
+ }
51
+ if (!TOOL_NAMES.includes(cmd ?? ""))
52
+ usage();
53
+ if (rest.length > 1)
54
+ usage();
55
+ let args = {};
56
+ if (rest.length === 1) {
57
+ try {
58
+ const parsed = JSON.parse(rest[0]);
59
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
60
+ usage();
61
+ }
62
+ args = parsed;
63
+ }
64
+ catch {
65
+ console.error("error: argument must be a JSON object string");
66
+ process.exit(2);
67
+ }
68
+ }
69
+ const result = await callTool(cmd, args);
70
+ if (result.isError) {
71
+ console.error(`error: ${firstText(result)}`);
72
+ process.exit(1);
73
+ }
74
+ console.log(typeof result.content === "string"
75
+ ? result.content
76
+ : JSON.stringify(result.content, null, 2));
77
+ }
78
+ void main();
79
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG7D,SAAS,KAAK;IACZ,OAAO,CAAC,KAAK,CAAC;gDACgC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;uBAE9C,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,MAAkB;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IACE,IAAI,KAAK,IAAI;gBACb,OAAO,IAAI,KAAK,QAAQ;gBACvB,IAA2B,CAAC,IAAI,KAAK,MAAM;gBAC5C,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,EACrD,CAAC;gBACD,OAAQ,IAAyB,CAAC,IAAI,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,KAAK,EAAE,CAAC;QAC/B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,cAAc,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC;QAAE,KAAK,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,EAAE,CAAC;IAC7B,IAAI,IAAI,GAA4B,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3E,KAAK,EAAE,CAAC;YACV,CAAC;YACD,IAAI,GAAG,MAAiC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CACT,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}
@@ -0,0 +1,86 @@
1
+ /**
2
+ * agencyfind core: a forwarding client for the hosted
3
+ * DouxProcess MCP server.
4
+ *
5
+ * No agency lookup happens on this machine. tools/list
6
+ * is answered from the literal definitions below, which
7
+ * reproduce a live capture of the upstream server word
8
+ * for word (name, title, description and inputSchema
9
+ * exactly as captured; search_servers and
10
+ * build_my_server carry no `required` key in the
11
+ * capture, so none is served for them). A tools/call
12
+ * travels upstream over a streamable-HTTP JSON-RPC
13
+ * session: an initialize POST, a
14
+ * notifications/initialized POST, then the tools/call
15
+ * POST, carrying the Mcp-Session-Id response header on
16
+ * later requests when the upstream issues one. The
17
+ * session opens lazily on the first forwarded call and
18
+ * is reused for the client's lifetime.
19
+ *
20
+ * The endpoint is pinned to https://douxprocess.com/mcp
21
+ * and may be replaced with the DOUXAGENCIES_MCP_URL
22
+ * environment variable (that override is a labelled
23
+ * reconstruction). The registry record declares NO
24
+ * headers on the upstream remote, so no auth header is
25
+ * ever sent, under any environment.
26
+ *
27
+ * A successful upstream result is returned exactly as
28
+ * received, isError flag and extra fields included.
29
+ * Failures — an upstream JSON-RPC error, a non-2xx
30
+ * status, a body that cannot be parsed, or a fetch
31
+ * that throws or times out — become an isError result
32
+ * whose text begins with `agencyfind error:` (that
33
+ * rendering is a labelled reconstruction). Replies may
34
+ * be plain JSON or SSE (`data:` lines); the JSON-RPC
35
+ * message whose id matches the request wins.
36
+ *
37
+ * LABELLED SUBSET: the upstream capture enumerates 5
38
+ * tools. Only `find_agencies`, `search_servers`,
39
+ * `get_server` and `build_my_server` are built here.
40
+ * `request_quote` is omitted (it sends a person's name,
41
+ * an email or phone, coverage details and a consent
42
+ * flag to the agency the person chose) and is never
43
+ * registered.
44
+ */
45
+ import type { ForwardDeps, ToolArgs, ToolDef, ToolResult } from "./types.js";
46
+ export declare const VERSION = "0.1.0";
47
+ export declare const DEFAULT_ENDPOINT_URL = "https://douxprocess.com/mcp";
48
+ export declare const DEFAULT_TIMEOUT_MS = 30000;
49
+ export declare const PROTOCOL_VERSION = "2025-03-26";
50
+ export declare const TOOL_DEFS: ToolDef[];
51
+ export declare const TOOL_NAMES: string[];
52
+ /** Whether `name` belongs to the captured built surface. */
53
+ export declare function isKnownTool(name: string): boolean;
54
+ /**
55
+ * Read a JSON-RPC response body, tolerating SSE framing.
56
+ * Returns the message whose id matches `expectedId` when
57
+ * present, otherwise the last parseable message, otherwise
58
+ * null when nothing in the body parses.
59
+ */
60
+ export declare function parseRpcBody(text: string, expectedId?: number): Record<string, unknown> | null;
61
+ /**
62
+ * A forwarding client holding a single upstream session,
63
+ * opened lazily on first use and reused from then on
64
+ * (for the process lifetime in the MCP server, or for a
65
+ * single invocation in the CLI).
66
+ */
67
+ export declare class AgencyfindClient {
68
+ private readonly deps;
69
+ private sessionId;
70
+ private ready;
71
+ private sessionPromise;
72
+ private idCounter;
73
+ constructor(deps?: ForwardDeps);
74
+ private fetchFn;
75
+ private endpointUrl;
76
+ private timeoutMs;
77
+ private nextId;
78
+ private post;
79
+ private ensureSession;
80
+ /** Forward one tool call; upstream failures come back as isError results. */
81
+ callTool(name: string, args: ToolArgs): Promise<ToolResult>;
82
+ }
83
+ /** Build a forwarding client; tests inject a fake fetch and env through deps. */
84
+ export declare function createClient(deps?: ForwardDeps): AgencyfindClient;
85
+ /** One-shot helper: a fresh client for a single call (the CLI path). */
86
+ export declare function callTool(name: string, args: ToolArgs, deps?: ForwardDeps): Promise<ToolResult>;
@@ -0,0 +1,346 @@
1
+ export const VERSION = "0.1.0";
2
+ export const DEFAULT_ENDPOINT_URL = "https://douxprocess.com/mcp";
3
+ export const DEFAULT_TIMEOUT_MS = 30000;
4
+ export const PROTOCOL_VERSION = "2025-03-26";
5
+ /* ------------------------------------------------------------------ */
6
+ /* Tool definitions (tools/list literals, verbatim from the live */
7
+ /* capture in harness/fixtures/douxagencies-tools-original.json; */
8
+ /* generated programmatically by parsing and re-serialising the */
9
+ /* fixture JSON, never retyped) */
10
+ /* ------------------------------------------------------------------ */
11
+ export const TOOL_DEFS = [
12
+ {
13
+ "name": "find_agencies",
14
+ "title": "Find a licensed insurance agency",
15
+ "description": "Find licensed insurance agencies that write a line of insurance (general liability, workers' comp, commercial auto, bonds, property, home, auto, life, health and more) in a US state, for someone who wants an insurance quote. Returns every matching agency in the DouxProcess network, best match first, with license number, lines, states, phone, hours and online quote link, so the person can choose one.",
16
+ "inputSchema": {
17
+ "type": "object",
18
+ "required": [
19
+ "line",
20
+ "state"
21
+ ],
22
+ "properties": {
23
+ "line": {
24
+ "type": "string",
25
+ "enum": [
26
+ "general-liability",
27
+ "workers-comp",
28
+ "commercial-auto",
29
+ "bonds",
30
+ "property",
31
+ "professional",
32
+ "cyber",
33
+ "personal-auto",
34
+ "home",
35
+ "life",
36
+ "health",
37
+ "other"
38
+ ],
39
+ "description": "Line of insurance."
40
+ },
41
+ "state": {
42
+ "type": "string",
43
+ "description": "Two-letter US state."
44
+ }
45
+ }
46
+ }
47
+ },
48
+ {
49
+ "name": "search_servers",
50
+ "title": "Find insurance MCP servers",
51
+ "description": "Search the free insurance MCP directory by line of insurance, US state, who it is for, or words. Each result says whether the server answered its last live check (every 30 minutes), its tool count and its address.",
52
+ "inputSchema": {
53
+ "type": "object",
54
+ "properties": {
55
+ "line": {
56
+ "type": "string",
57
+ "enum": [
58
+ "general-liability",
59
+ "workers-comp",
60
+ "commercial-auto",
61
+ "bonds",
62
+ "property",
63
+ "professional",
64
+ "cyber",
65
+ "personal-auto",
66
+ "home",
67
+ "life",
68
+ "health",
69
+ "other"
70
+ ]
71
+ },
72
+ "state": {
73
+ "type": "string",
74
+ "description": "Two-letter US state."
75
+ },
76
+ "audience": {
77
+ "type": "string",
78
+ "enum": [
79
+ "consumer",
80
+ "agent"
81
+ ]
82
+ },
83
+ "query": {
84
+ "type": "string",
85
+ "description": "Words to match in the name or summary."
86
+ },
87
+ "live_only": {
88
+ "type": "boolean",
89
+ "description": "Only servers that answered the last check."
90
+ }
91
+ }
92
+ }
93
+ },
94
+ {
95
+ "name": "get_server",
96
+ "title": "One server, in full",
97
+ "description": "Everything about one listed server: its tools from the last live check, its address and how to add it to Claude, ChatGPT, Gemini or Grok.",
98
+ "inputSchema": {
99
+ "type": "object",
100
+ "required": [
101
+ "slug"
102
+ ],
103
+ "properties": {
104
+ "slug": {
105
+ "type": "string",
106
+ "description": "The slug from search_servers."
107
+ }
108
+ }
109
+ }
110
+ },
111
+ {
112
+ "name": "build_my_server",
113
+ "title": "Build an MCP server for my agency",
114
+ "description": "How an insurance agency gets its own MCP server, free: the builder link and what it makes.",
115
+ "inputSchema": {
116
+ "type": "object",
117
+ "properties": {}
118
+ }
119
+ }
120
+ ];
121
+ export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
122
+ /** Whether `name` belongs to the captured built surface. */
123
+ export function isKnownTool(name) {
124
+ return TOOL_NAMES.includes(name);
125
+ }
126
+ /* ------------------------------------------------------------------ */
127
+ /* Forwarding client */
128
+ /* ------------------------------------------------------------------ */
129
+ function errorResult(detail) {
130
+ return {
131
+ content: [{ type: "text", text: `agencyfind error: ${detail}` }],
132
+ isError: true,
133
+ };
134
+ }
135
+ function rpcErrorMessage(error) {
136
+ if (error !== null && typeof error === "object") {
137
+ const message = error.message;
138
+ if (typeof message === "string" && message !== "")
139
+ return message;
140
+ return JSON.stringify(error);
141
+ }
142
+ return String(error);
143
+ }
144
+ /**
145
+ * Read a JSON-RPC response body, tolerating SSE framing.
146
+ * Returns the message whose id matches `expectedId` when
147
+ * present, otherwise the last parseable message, otherwise
148
+ * null when nothing in the body parses.
149
+ */
150
+ export function parseRpcBody(text, expectedId) {
151
+ const trimmed = text.trim();
152
+ if (trimmed === "")
153
+ return null;
154
+ const candidates = [];
155
+ const tryPush = (payload) => {
156
+ try {
157
+ const parsed = JSON.parse(payload);
158
+ if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
159
+ candidates.push(parsed);
160
+ }
161
+ }
162
+ catch {
163
+ // Not a JSON payload; skip this candidate.
164
+ }
165
+ };
166
+ if (trimmed.includes("data:")) {
167
+ for (const line of trimmed.split("\n")) {
168
+ const t = line.trim();
169
+ if (!t.startsWith("data:"))
170
+ continue;
171
+ const payload = t.slice("data:".length).trim();
172
+ if (payload !== "" && payload !== "[DONE]")
173
+ tryPush(payload);
174
+ }
175
+ }
176
+ else {
177
+ tryPush(trimmed);
178
+ }
179
+ if (candidates.length === 0)
180
+ return null;
181
+ if (expectedId !== undefined) {
182
+ const match = candidates.find((c) => c.id === expectedId);
183
+ if (match !== undefined)
184
+ return match;
185
+ }
186
+ return candidates[candidates.length - 1];
187
+ }
188
+ async function defaultFetch(url, init) {
189
+ return fetch(url, init);
190
+ }
191
+ /**
192
+ * A forwarding client holding a single upstream session,
193
+ * opened lazily on first use and reused from then on
194
+ * (for the process lifetime in the MCP server, or for a
195
+ * single invocation in the CLI).
196
+ */
197
+ export class AgencyfindClient {
198
+ deps;
199
+ sessionId = null;
200
+ ready = false;
201
+ sessionPromise = null;
202
+ idCounter = 0;
203
+ constructor(deps = {}) {
204
+ this.deps = deps;
205
+ }
206
+ fetchFn() {
207
+ return this.deps.fetchFn ?? defaultFetch;
208
+ }
209
+ endpointUrl() {
210
+ if (this.deps.url && this.deps.url.trim() !== "")
211
+ return this.deps.url.trim();
212
+ const raw = (this.deps.env ?? process.env).DOUXAGENCIES_MCP_URL;
213
+ if (raw && raw.trim() !== "")
214
+ return raw.trim();
215
+ return DEFAULT_ENDPOINT_URL;
216
+ }
217
+ timeoutMs() {
218
+ if (typeof this.deps.timeoutMs === "number" && this.deps.timeoutMs > 0) {
219
+ return this.deps.timeoutMs;
220
+ }
221
+ return DEFAULT_TIMEOUT_MS;
222
+ }
223
+ nextId() {
224
+ this.idCounter += 1;
225
+ return this.idCounter;
226
+ }
227
+ async post(body, withSession) {
228
+ // The registry record declares NO headers on the upstream
229
+ // remote: no Authorization header is ever sent.
230
+ const headers = {
231
+ "Content-Type": "application/json",
232
+ Accept: "application/json, text/event-stream",
233
+ };
234
+ if (withSession && this.sessionId !== null) {
235
+ headers["Mcp-Session-Id"] = this.sessionId;
236
+ }
237
+ const controller = new AbortController();
238
+ const timer = setTimeout(() => controller.abort(), this.timeoutMs());
239
+ try {
240
+ return await this.fetchFn()(this.endpointUrl(), {
241
+ method: "POST",
242
+ headers,
243
+ body: JSON.stringify(body),
244
+ signal: controller.signal,
245
+ });
246
+ }
247
+ finally {
248
+ clearTimeout(timer);
249
+ }
250
+ }
251
+ async ensureSession() {
252
+ if (this.ready)
253
+ return;
254
+ if (this.sessionPromise === null) {
255
+ this.sessionPromise = (async () => {
256
+ const initId = this.nextId();
257
+ const initRes = await this.post({
258
+ jsonrpc: "2.0",
259
+ id: initId,
260
+ method: "initialize",
261
+ params: {
262
+ protocolVersion: PROTOCOL_VERSION,
263
+ capabilities: {},
264
+ clientInfo: { name: "agencyfind", version: VERSION },
265
+ },
266
+ }, false);
267
+ const sessionId = initRes.headers.get("mcp-session-id");
268
+ if (sessionId)
269
+ this.sessionId = sessionId;
270
+ const initText = await initRes.text();
271
+ const initParsed = parseRpcBody(initText, initId);
272
+ if (initParsed !== null && initParsed.error) {
273
+ throw new Error(rpcErrorMessage(initParsed.error));
274
+ }
275
+ if (initRes.status < 200 || initRes.status >= 300) {
276
+ throw new Error(`HTTP ${initRes.status}`);
277
+ }
278
+ if (initParsed === null && initText.trim() !== "") {
279
+ throw new Error("malformed response");
280
+ }
281
+ const initializedRes = await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, true);
282
+ try {
283
+ await initializedRes.text();
284
+ }
285
+ catch {
286
+ // Nothing needed from the notification response body.
287
+ }
288
+ this.ready = true;
289
+ })();
290
+ }
291
+ try {
292
+ await this.sessionPromise;
293
+ }
294
+ catch (err) {
295
+ this.sessionPromise = null;
296
+ this.sessionId = null;
297
+ throw err;
298
+ }
299
+ }
300
+ /** Forward one tool call; upstream failures come back as isError results. */
301
+ async callTool(name, args) {
302
+ try {
303
+ await this.ensureSession();
304
+ }
305
+ catch (err) {
306
+ return errorResult(err instanceof Error ? err.message : String(err));
307
+ }
308
+ const callId = this.nextId();
309
+ let callRes;
310
+ try {
311
+ callRes = await this.post({
312
+ jsonrpc: "2.0",
313
+ id: callId,
314
+ method: "tools/call",
315
+ params: { name, arguments: args ?? {} },
316
+ }, true);
317
+ }
318
+ catch (err) {
319
+ return errorResult(`request failed: ${err instanceof Error ? err.message : String(err)}`);
320
+ }
321
+ const parsed = parseRpcBody(await callRes.text(), callId);
322
+ if (parsed !== null && parsed.error) {
323
+ return errorResult(rpcErrorMessage(parsed.error));
324
+ }
325
+ if (callRes.status < 200 || callRes.status >= 300) {
326
+ return errorResult(`HTTP ${callRes.status}`);
327
+ }
328
+ if (parsed === null)
329
+ return errorResult("malformed response");
330
+ const result = parsed.result;
331
+ if (result === undefined || result === null || typeof result !== "object") {
332
+ return errorResult("malformed response");
333
+ }
334
+ // Hand the upstream result back exactly as received.
335
+ return result;
336
+ }
337
+ }
338
+ /** Build a forwarding client; tests inject a fake fetch and env through deps. */
339
+ export function createClient(deps = {}) {
340
+ return new AgencyfindClient(deps);
341
+ }
342
+ /** One-shot helper: a fresh client for a single call (the CLI path). */
343
+ export async function callTool(name, args, deps = {}) {
344
+ return new AgencyfindClient(deps).callTool(name, args);
345
+ }
346
+ //# sourceMappingURL=forward.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from "./types.js";
2
+ export * from "./forward.js";
package/dist/index.js ADDED
@@ -0,0 +1,3 @@
1
+ export * from "./types.js";
2
+ export * from "./forward.js";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
package/dist/mcp.d.ts ADDED
@@ -0,0 +1,33 @@
1
+ /**
2
+ * agencyfind MCP server. Tools: the 4 built captured
3
+ * DouxProcess tools (see forward.ts).
4
+ *
5
+ * This file uses the low-level Server API rather than
6
+ * McpServer: the high-level helper rebuilds schemas from
7
+ * zod and rewrites what is served, which would break
8
+ * exact parity with the captured tools/list. Here
9
+ * tools/list is answered locally from the core's literal
10
+ * definitions — the verbatim objects from the upstream
11
+ * capture — and every tools/call is forwarded upstream.
12
+ *
13
+ * A forwarded result returns unchanged, upstream isError
14
+ * flag and extra fields included. An upstream failure
15
+ * arrives as an isError result carrying a
16
+ * `agencyfind error:` text, built by the forwarding
17
+ * client. Unknown tool names are rejected with McpError
18
+ * MethodNotFound, and non-object arguments with McpError
19
+ * InvalidParams, before any network hop is made.
20
+ */
21
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
22
+ import { type AgencyfindClient } from "./forward.js";
23
+ import type { ForwardDeps, ToolResult } from "./types.js";
24
+ /**
25
+ * Validate and forward a single tools/call through
26
+ * `client`. Exported so this layer can be tested directly
27
+ * without a stdio transport.
28
+ */
29
+ export declare function handleCallTool(client: AgencyfindClient, name: string, args: unknown): Promise<ToolResult>;
30
+ /** Build the stdio MCP server (transport not yet connected). */
31
+ export declare function createServer(deps?: ForwardDeps): Server;
32
+ /** Connect the MCP server over stdio. */
33
+ export declare function startMcpServer(deps?: ForwardDeps): Promise<void>;
package/dist/mcp.js ADDED
@@ -0,0 +1,58 @@
1
+ /**
2
+ * agencyfind MCP server. Tools: the 4 built captured
3
+ * DouxProcess tools (see forward.ts).
4
+ *
5
+ * This file uses the low-level Server API rather than
6
+ * McpServer: the high-level helper rebuilds schemas from
7
+ * zod and rewrites what is served, which would break
8
+ * exact parity with the captured tools/list. Here
9
+ * tools/list is answered locally from the core's literal
10
+ * definitions — the verbatim objects from the upstream
11
+ * capture — and every tools/call is forwarded upstream.
12
+ *
13
+ * A forwarded result returns unchanged, upstream isError
14
+ * flag and extra fields included. An upstream failure
15
+ * arrives as an isError result carrying a
16
+ * `agencyfind error:` text, built by the forwarding
17
+ * client. Unknown tool names are rejected with McpError
18
+ * MethodNotFound, and non-object arguments with McpError
19
+ * InvalidParams, before any network hop is made.
20
+ */
21
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
22
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
23
+ import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
24
+ import { createClient, isKnownTool, TOOL_DEFS, VERSION, } from "./forward.js";
25
+ /**
26
+ * Validate and forward a single tools/call through
27
+ * `client`. Exported so this layer can be tested directly
28
+ * without a stdio transport.
29
+ */
30
+ export async function handleCallTool(client, name, args) {
31
+ if (!isKnownTool(name)) {
32
+ throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
33
+ }
34
+ if (args !== undefined &&
35
+ (typeof args !== "object" || args === null || Array.isArray(args))) {
36
+ throw new McpError(ErrorCode.InvalidParams, `Arguments for tool ${name} must be a JSON object`);
37
+ }
38
+ return client.callTool(name, (args ?? {}));
39
+ }
40
+ /** Build the stdio MCP server (transport not yet connected). */
41
+ export function createServer(deps = {}) {
42
+ const client = createClient(deps);
43
+ const server = new Server({ name: "agencyfind", version: VERSION }, { capabilities: { tools: {} } });
44
+ server.setRequestHandler(ListToolsRequestSchema, async () => ({
45
+ tools: TOOL_DEFS,
46
+ }));
47
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
48
+ const { name, arguments: args } = request.params;
49
+ const result = await handleCallTool(client, name, args);
50
+ return result;
51
+ });
52
+ return server;
53
+ }
54
+ /** Connect the MCP server over stdio. */
55
+ export async function startMcpServer(deps = {}) {
56
+ await createServer(deps).connect(new StdioServerTransport());
57
+ }
58
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,OAAO,GAER,MAAM,cAAc,CAAC;AAGtB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAwB,EACxB,IAAY,EACZ,IAAa;IAEb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IACE,IAAI,KAAK,SAAS;QAClB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,sBAAsB,IAAI,wBAAwB,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;AACxE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE;IACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,MAAe,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAoB,EAAE;IACzD,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * agencyfind types.
3
+ *
4
+ * This package holds no directory data of its own. It is a
5
+ * forwarding client: the captured DouxProcess tool surface
6
+ * is kept as plain data (ToolDef entries served verbatim
7
+ * for tools/list) and each tools/call is sent to the
8
+ * hosted DouxProcess MCP endpoint through an injectable
9
+ * fetch, so the whole test suite can run against a
10
+ * stubbed upstream with no live network.
11
+ */
12
+ /** One captured tool definition, served exactly as captured for tools/list. */
13
+ export interface ToolDef {
14
+ name: string;
15
+ title?: string;
16
+ description: string;
17
+ inputSchema: Record<string, unknown>;
18
+ [key: string]: unknown;
19
+ }
20
+ /** Arguments for a tool call, as decoded JSON. */
21
+ export type ToolArgs = Record<string, unknown>;
22
+ /** A tools/call result: upstream payloads pass through verbatim; local failures use this shape too. */
23
+ export interface ToolResult {
24
+ content?: unknown;
25
+ isError?: boolean;
26
+ [key: string]: unknown;
27
+ }
28
+ /** The narrow slice of a fetch Response the forwarding client relies on. */
29
+ export interface FetchResponseLike {
30
+ ok: boolean;
31
+ status: number;
32
+ headers: {
33
+ get(name: string): string | null;
34
+ };
35
+ text(): Promise<string>;
36
+ }
37
+ /** Injectable fetch function, so tests never reach the live network. */
38
+ export type FetchFn = (url: string, init?: {
39
+ method?: string;
40
+ headers?: Record<string, string>;
41
+ body?: string;
42
+ signal?: AbortSignal;
43
+ }) => Promise<FetchResponseLike>;
44
+ /** Injectable runtime dependencies for the forwarding client. */
45
+ export interface ForwardDeps {
46
+ /** Fetch implementation. Defaults to the global fetch. */
47
+ fetchFn?: FetchFn;
48
+ /** Environment (DOUXAGENCIES_MCP_URL). Defaults to process.env. */
49
+ env?: Record<string, string | undefined>;
50
+ /** Endpoint URL override. Defaults to env DOUXAGENCIES_MCP_URL or the pinned default. */
51
+ url?: string;
52
+ /** Per-request timeout in milliseconds. Defaults to 30000. */
53
+ timeoutMs?: number;
54
+ }
package/dist/types.js ADDED
@@ -0,0 +1,13 @@
1
+ /**
2
+ * agencyfind types.
3
+ *
4
+ * This package holds no directory data of its own. It is a
5
+ * forwarding client: the captured DouxProcess tool surface
6
+ * is kept as plain data (ToolDef entries served verbatim
7
+ * for tools/list) and each tools/call is sent to the
8
+ * hosted DouxProcess MCP endpoint through an injectable
9
+ * fetch, so the whole test suite can run against a
10
+ * stubbed upstream with no live network.
11
+ */
12
+ export {};
13
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}
package/package.json CHANGED
@@ -1,6 +1 @@
1
- {
2
- "name": "@reneturcios/agencyfind",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
1
+ {"bin":{"agencyfind":"dist/cli.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1","zod":"^4"},"description":"Find licensed US insurance agencies and insurance MCP servers by line, state and audience, forwarded from the hosted DouxProcess service. One bin serves a small CLI and the MCP server.","devDependencies":{"@types/node":"^20","tsx":"^4","typescript":"^5"},"engines":{"node":">=20"},"files":["dist","server.json"],"homepage":"https://github.com/CloudCorpRecords/agencyfind#readme","license":"MIT","mcpName":"io.github.CloudCorpRecords/agencyfind","name":"@reneturcios/agencyfind","private":false,"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/CloudCorpRecords/agencyfind.git"},"scripts":{"build":"tsc","dev":"tsx src/cli.ts","test":"tsx --test test/*.test.ts"},"type":"module","version":"0.1.0"}
package/server.json ADDED
@@ -0,0 +1 @@
1
+ {"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Find licensed US insurance agencies and insurance MCP servers by line, state and audience.","name":"io.github.CloudCorpRecords/agencyfind","packages":[{"identifier":"@reneturcios/agencyfind","packageArguments":[{"type":"positional","value":"mcp"}],"registryBaseUrl":"https://registry.npmjs.org","registryType":"npm","runtimeHint":"npx","transport":{"type":"stdio"},"version":"0.1.0"},{"identifier":"ghcr.io/cloudcorprecords/agencyfind:0.1.0","packageArguments":[{"type":"positional","value":"mcp"}],"registryType":"oci","runtimeArguments":[{"name":"--rm","type":"named"},{"name":"-i","type":"named"}],"runtimeHint":"docker","transport":{"type":"stdio"}}],"repository":{"source":"github","url":"https://github.com/CloudCorpRecords/agencyfind"},"version":"0.1.0"}