@msegoviadev/api-mind-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcos Segovia
+
+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,245 @@
+# api-mind MCP Server
+
+MCP server for API discovery from `.mind` spec files. Works with Claude Code, Claude Desktop, and any MCP-compatible AI assistant.
+
+## Why
+
+LLMs interacting with HTTP APIs need to discover endpoints, understand contracts, and make requests. api-mind provides 3 tools for discovery and context:
+
+- **list_apis** - Discover available APIs
+- **list_endpoints** - Find endpoints across APIs
+- **get_endpoint_schema** - Get base URL, auth requirements, and schema
+
+The LLM then constructs and executes curl commands with full transparency.
+
+## Installation
+
+### Option 1: Command-line argument (Recommended)
+
+```bash
+claude mcp add --transport stdio api-mind \
+  -- npx -y @msegoviadev/api-mind-mcp /Users/YOUR/absolute/path/to/specs
+```
+
+**Important:** Use ABSOLUTE paths. Relative paths are not supported.
+
+### Option 2: Environment variable
+
+```bash
+claude mcp add --transport stdio api-mind \
+  --env SPECS_DIR=/Users/YOUR/absolute/path/to/specs \
+  -- npx -y @msegoviadev/api-mind-mcp
+```
+
+### Option 3: Project configuration (Best for Teams)
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "api-mind": {
+      "command": "npx",
+      "args": ["-y", "@msegoviadev/api-mind-mcp"],
+      "env": {
+        "SPECS_DIR": "/Users/yourname/projects/yourproject/specs"
+      }
+    }
+  }
+}
+```
+
+**Note:** Each team member needs their own `.mcp.json` with their absolute path. Add `.mcp.json` to `.gitignore`.
+
+### Setup Script for Teams
+
+Create `setup-mcp.sh` in your project root:
+
+```bash
+#!/bin/bash
+PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"
+claude mcp add --transport stdio --scope project api-mind \
+  --env SPECS_DIR="${PROJECT_ROOT}/specs" \
+  -- npx -y @msegoviadev/api-mind-mcp
+```
+
+Team members run once:
+```bash
+chmod +x setup-mcp.sh
+./setup-mcp.sh
+```
+
+## Local Development
+
+For testing locally:
+
+```bash
+cd /path/to/api-mind-claude
+npm install
+npm run build
+
+# Test with command-line argument
+node dist/index.js /absolute/path/to/specs
+
+# Test with environment variable
+SPECS_DIR=/absolute/path/to/specs node dist/index.js
+
+# Add to Claude Code for testing
+claude mcp add --transport stdio api-mind-dev \
+  -- node /path/to/api-mind-claude/dist/index.js /absolute/path/to/specs
+```
+
+## Setup
+
+### 1. Add OpenAPI specs
+
+```bash
+mkdir specs
+# Copy your OpenAPI/Swagger YAML/JSON files to specs/
+```
+
+### 2. Generate .mind files
+
+```bash
+npm install -g @msegoviadev/spec-mind
+spec-mind sync --no-notation ./specs/
+```
+
+### 3. Commit both files
+
+```bash
+git add specs/*.yaml specs/*.mind
+git commit -m "Add API specs"
+```
+
+### 4. Configure api-mind
+
+Use one of the installation methods above to configure the specs directory.
+
+## Tools
+
+### list_apis
+
+Lists all APIs loaded from the specs folder.
+
+```
+Input: none
+Output: JSON with API names, titles, base URLs, and environments
+```
+
+Call first to discover what APIs are available.
+
+### list_endpoints
+
+Lists endpoints across all APIs.
+
+```
+Input:
+  filter (optional): Substring match on method, path, or section
+
+Output: JSON with environments and endpoint list
+```
+
+Call to find specific endpoints.
+
+### get_endpoint_schema
+
+Returns full context for an endpoint.
+
+```
+Input:
+  api: API name
+  method: HTTP method
+  path: Endpoint path
+
+Output: Text block with base URL, environments, auth, and schema
+```
+
+Call before constructing curl to understand the endpoint.
+
+## Workflow
+
+```
+list_apis → list_endpoints → get_endpoint_schema → [LLM constructs curl] → bash
+```
+
+1. `list_apis` - Discover available APIs
+2. `list_endpoints` - Find relevant endpoints
+3. `get_endpoint_schema` - Get context (URL, auth, schema)
+4. LLM constructs curl command with proper URL and headers
+5. LLM executes via `bash` tool
+
+## Auth Patterns
+
+When `get_endpoint_schema` shows auth requirements, construct headers:
+
+| Auth in Schema | curl Header |
+|----------------|-------------|
+| `None` | No header |
+| `bearer` | `-H 'Authorization: Bearer <TOKEN>'` |
+| `oauth2 <scopes>` | `-H 'Authorization: Bearer <TOKEN>'` |
+| `api_key <header>` | `-H '<header>: <KEY>'` |
+| `basic` | `-H 'Authorization: Basic <base64>'` |
+
+## Why Absolute Paths?
+
+MCP servers run as standalone processes without project context. The working directory may be `/` or a system directory. Unlike plugins that receive project context, MCP servers must receive explicit configuration.
+
+Always use absolute paths when configuring MCP servers.
+
+## Example Usage
+
+Once configured, use the tools directly in Claude Code:
+
+```
+User: "What APIs are available?"
+Claude: *uses list_apis tool*
+"I found 2 APIs loaded:
+1. ecommerce - E-commerce API
+2. payments - Payments API"
+
+User: "Show me the endpoints for creating a payment"
+Claude: *uses list_endpoints tool with filter="payment"*
+"Here are payment endpoints:
+POST /payments [auth: oauth2 payments:write]
+..."
+
+User: "Get the schema for POST /payments"
+Claude: *uses get_endpoint_schema tool*
+"POST /payments
+Auth: oauth2 payments:write
+Body: CreatePaymentRequest {...}
+..."
+```
+
+## NOTATION Legend
+
+The schema uses a compact notation:
+
+```
+? optional | [ro] readOnly | [w] writeOnly | =val default
+^ header | ~ cookie | | enum | {*:T} map | ~~name~~ deprecated
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test Locally
+
+```bash
+node dist/index.js /absolute/path/to/specs
+```
+
+## Related
+
+- [spec-mind](https://github.com/msegoviadev/spec-mind) - Generate `.mind` files from OpenAPI specs
+- [api-mind](https://github.com/msegoviadev/api-mind) - OpenCode plugin version
+
+## License
+
+MIT

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./parser";
+export * from "./loader";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./loader"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,2CAAwB;AACxB,2CAAwB"}

package/dist/core/loader.d.ts

@@ -0,0 +1,23 @@
+import type { EndpointIndex, EndpointEntry, InitOptions, GetEndpointSchemaResult } from "./types";
+export declare function initIndex(options: InitOptions): Promise<EndpointIndex>;
+export declare function getIndex(): Promise<EndpointIndex>;
+export declare function clearIndex(): void;
+export declare function getSpecsDir(): string | null;
+export declare function rebuildIndex(): Promise<EndpointIndex>;
+export declare function listApis(): Promise<{
+    apis: Array<{
+        name: string;
+        title: string;
+        defaultUrl: string;
+        environments: Record<string, string>;
+    }>;
+}>;
+export declare function listEndpoints(filter?: string): Promise<{
+    environments: string[];
+    endpoints: EndpointEntry[];
+}>;
+export declare function getEndpointSchema(api: string, method: string, path: string): Promise<GetEndpointSchemaResult>;
+export declare function setFileReader(fn: (path: string) => Promise<string>): void;
+export declare function setDirReader(fn: (dir: string) => Promise<string[]>): void;
+export declare function setPathJoiner(fn: (...parts: string[]) => string): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAW,aAAa,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAM1G,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAI5E;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAKvD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAK3D;AAgED,wBAAsB,QAAQ,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CASpJ;AAED,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAiBpH;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA8BnH;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAEzE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAEzE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAEtE"}

package/dist/core/loader.js

@@ -0,0 +1,208 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initIndex = initIndex;
+exports.getIndex = getIndex;
+exports.clearIndex = clearIndex;
+exports.getSpecsDir = getSpecsDir;
+exports.rebuildIndex = rebuildIndex;
+exports.listApis = listApis;
+exports.listEndpoints = listEndpoints;
+exports.getEndpointSchema = getEndpointSchema;
+exports.setFileReader = setFileReader;
+exports.setDirReader = setDirReader;
+exports.setPathJoiner = setPathJoiner;
+const parser_1 = require("./parser");
+let indexPromise = null;
+let currentSpecsDir = null;
+async function initIndex(options) {
+    currentSpecsDir = options.specsDir;
+    indexPromise = buildIndex(options.specsDir);
+    return indexPromise;
+}
+async function getIndex() {
+    if (!indexPromise) {
+        throw new Error("Index not initialized. Call initIndex() first.");
+    }
+    return indexPromise;
+}
+function clearIndex() {
+    indexPromise = null;
+    currentSpecsDir = null;
+}
+function getSpecsDir() {
+    return currentSpecsDir;
+}
+async function rebuildIndex() {
+    if (!currentSpecsDir) {
+        throw new Error("No specs directory configured. Call initIndex() first.");
+    }
+    return initIndex({ specsDir: currentSpecsDir });
+}
+async function buildIndex(specsDir) {
+    const files = await scanMindFiles(specsDir);
+    const apis = {};
+    const allEndpoints = [];
+    const allEnvironments = new Set();
+    await Promise.all(files.map(async (filePath) => {
+        const content = await readFile(filePath);
+        const apiName = extractApiName(filePath);
+        const apiHeader = (0, parser_1.parseApiHeader)(content);
+        if (!apiHeader) {
+            console.error(`[api-mind] No API header found in ${filePath}`);
+            return;
+        }
+        const servers = (0, parser_1.parseServers)(content);
+        const parsedEndpoints = (0, parser_1.parseEndpoints)(content);
+        const endpoints = parsedEndpoints.map(ep => ({
+            api: apiName,
+            section: ep.section,
+            method: ep.method,
+            path: ep.path,
+            auth: ep.auth,
+        }));
+        apis[apiName] = {
+            filePath,
+            title: apiHeader.title,
+            defaultUrl: apiHeader.defaultUrl,
+            servers,
+        };
+        allEndpoints.push(...endpoints);
+        Object.keys(servers).forEach(env => allEnvironments.add(env.toLowerCase()));
+    }));
+    return {
+        environments: Array.from(allEnvironments).sort(),
+        apis,
+        endpoints: allEndpoints,
+    };
+}
+async function scanMindFiles(dir) {
+    try {
+        const entries = await readDir(dir);
+        return entries
+            .filter(entry => entry.endsWith(".mind"))
+            .map(entry => joinPath(dir, entry));
+    }
+    catch {
+        console.debug(`[api-mind] Directory not found: ${dir}`);
+        return [];
+    }
+}
+function extractApiName(filePath) {
+    const fileName = filePath.split("/").pop() || "";
+    return fileName.replace(/\.mind$/, "");
+}
+async function listApis() {
+    const index = await getIndex();
+    const apis = Object.entries(index.apis).map(([name, meta]) => ({
+        name,
+        title: meta.title,
+        defaultUrl: meta.defaultUrl,
+        environments: meta.servers,
+    }));
+    return { apis };
+}
+async function listEndpoints(filter) {
+    const index = await getIndex();
+    let endpoints = index.endpoints;
+    if (filter) {
+        const lowerFilter = filter.toLowerCase();
+        endpoints = endpoints.filter(ep => ep.method.toLowerCase().includes(lowerFilter) ||
+            ep.path.toLowerCase().includes(lowerFilter) ||
+            ep.section.toLowerCase().includes(lowerFilter));
+    }
+    return {
+        environments: index.environments,
+        endpoints,
+    };
+}
+async function getEndpointSchema(api, method, path) {
+    const index = await getIndex();
+    const apiMeta = index.apis[api];
+    if (!apiMeta) {
+        throw new Error(`API "${api}" not found. Available: ${Object.keys(index.apis).join(", ")}`);
+    }
+    const content = await readFile(apiMeta.filePath);
+    const { parseFullEndpoint } = await Promise.resolve().then(() => __importStar(require("./parser")));
+    const block = parseFullEndpoint(content, method, path);
+    if (!block) {
+        throw new Error(`Endpoint ${method} ${path} not found in API "${api}"`);
+    }
+    const endpoint = index.endpoints.find(ep => ep.api === api && ep.method === method && ep.path === path);
+    return {
+        api,
+        title: apiMeta.title,
+        defaultUrl: apiMeta.defaultUrl,
+        environments: apiMeta.servers,
+        method,
+        path,
+        auth: endpoint?.auth || null,
+        schema: block,
+    };
+}
+let _readFile = null;
+let _readDir = null;
+let _joinPath = null;
+function setFileReader(fn) {
+    _readFile = fn;
+}
+function setDirReader(fn) {
+    _readDir = fn;
+}
+function setPathJoiner(fn) {
+    _joinPath = fn;
+}
+async function readFile(path) {
+    if (_readFile) {
+        return _readFile(path);
+    }
+    const fs = await Promise.resolve().then(() => __importStar(require("fs/promises")));
+    return fs.readFile(path, "utf-8");
+}
+async function readDir(dir) {
+    if (_readDir) {
+        return _readDir(dir);
+    }
+    const fs = await Promise.resolve().then(() => __importStar(require("fs/promises")));
+    const entries = await fs.readdir(dir);
+    return entries;
+}
+function joinPath(...parts) {
+    if (_joinPath) {
+        return _joinPath(...parts);
+    }
+    return parts.join("/").replace(/\/+/g, "/");
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"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"}

package/dist/core/parser.d.ts

@@ -0,0 +1,17 @@
+import type { ParsedApiHeader, ParsedEndpoint } from "./types";
+export declare function parseApiHeader(content: string): ParsedApiHeader | null;
+export declare function parseServers(content: string): Record<string, string>;
+export declare function stripDeprecationWrapper(method: string): string;
+export declare function normalizePath(path: string): string;
+export declare function parseEndpointLine(line: string): {
+    method: string;
+    path: string;
+    auth?: string;
+} | null;
+export declare function parseEndpoints(content: string): ParsedEndpoint[];
+export declare function findEndpointBlock(content: string, method: string, path: string): string | null;
+export declare function extractSchemaRefs(block: string): string[];
+export declare function findSchemaBlock(content: string, schemaName: string): string | null;
+export declare function collectSchemas(content: string, endpointBlock: string): string;
+export declare function parseFullEndpoint(content: string, method: string, path: string): string | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAQ9D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYtE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBpE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAStG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAgChE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+B9F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+BlF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAsB7E;AAuBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW9F"}