@y2-intel/mcp 0.1.0

package/examples/codex.md

@@ -0,0 +1,28 @@
+# Codex
+
+Install the Y2 MCP server with the Codex CLI:
+
+```sh
+export Y2_API_KEY=y2_...
+
+codex mcp add y2 --env Y2_API_KEY=$Y2_API_KEY -- npx -y @y2-intel/mcp
+```
+
+Equivalent `config.toml`:
+
+```toml
+[mcp_servers.y2]
+command = "npx"
+args = ["-y", "@y2-intel/mcp"]
+env_vars = ["Y2_API_KEY"]
+startup_timeout_sec = 20
+tool_timeout_sec = 120
+default_tools_approval_mode = "prompt"
+```
+
+Use the default prompt approval mode until you are comfortable with which Y2
+tools are enabled for the API key.
+
+Agent Y2 is disabled by default. To expose `y2_ask_agent`, export
+`Y2_MCP_ENABLE_AGENT=1` and add it to `env_vars` alongside `Y2_API_KEY`. Use a
+Y2 API key with `agent:y2` only when Agent Y2 account actions are intended.

package/examples/mcp-inspector.md

@@ -0,0 +1,53 @@
+# MCP Inspector
+
+Build first:
+
+```sh
+npm install
+npm run build
+```
+
+List server capabilities:
+
+```sh
+npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
+npx @modelcontextprotocol/inspector --cli node dist/index.js --method resources/list
+npx @modelcontextprotocol/inspector --cli node dist/index.js --method prompts/list
+```
+
+Agent Y2 is hidden by default. To verify the opt-in tool surface:
+
+```sh
+npx @modelcontextprotocol/inspector --cli \
+  -e Y2_MCP_ENABLE_AGENT=1 \
+  node dist/index.js \
+  --method tools/list
+```
+
+Call a no-key tool:
+
+```sh
+npx @modelcontextprotocol/inspector --cli node dist/index.js \
+  --method tools/call \
+  --tool-name y2_get_openapi_operation \
+  --tool-arg operationId=listReports
+```
+
+Read a no-key resource:
+
+```sh
+npx @modelcontextprotocol/inspector --cli node dist/index.js \
+  --method resources/read \
+  --uri y2://quickstart
+```
+
+Call a scoped Y2 API tool:
+
+```sh
+npx @modelcontextprotocol/inspector --cli \
+  -e Y2_API_KEY=$Y2_API_KEY \
+  node dist/index.js \
+  --method tools/call \
+  --tool-name y2_list_reports \
+  --tool-arg limit=1
+```

package/package.json

@@ -0,0 +1,71 @@
+{
+	"name": "@y2-intel/mcp",
+	"version": "0.1.0",
+	"description": "MCP server for connecting AI agents to Y2",
+	"type": "module",
+	"license": "Apache-2.0",
+	"author": "Y2",
+	"homepage": "https://y2.dev/docs/api/mcp",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/y2-intel/mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/y2-intel/mcp/issues"
+	},
+	"keywords": [
+		"mcp",
+		"model-context-protocol",
+		"claude",
+		"codex",
+		"ai-agents",
+		"y2",
+		"intelligence",
+		"openapi"
+	],
+	"bin": {
+		"y2-mcp": "dist/index.js"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE",
+		"SECURITY.md",
+		"CHANGELOG.md",
+		"examples",
+		"server.json"
+	],
+	"mcpName": "io.github.y2-intel/mcp",
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"dev": "tsx src/index.ts",
+		"inspect:all": "npm run inspect:tools && npm run inspect:resources && npm run inspect:prompts && npm run inspect:openapi && npm run inspect:no-key-error",
+		"inspect:no-key-error": "npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call --tool-name y2_list_reports --tool-arg limit=1",
+		"inspect:openapi": "npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call --tool-name y2_get_openapi_operation --tool-arg operationId=listReports",
+		"inspect:prompts": "npx @modelcontextprotocol/inspector --cli node dist/index.js --method prompts/list",
+		"inspect:resources": "npx @modelcontextprotocol/inspector --cli node dist/index.js --method resources/list",
+		"inspect:tools": "npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list",
+		"prepublishOnly": "npm run release:check",
+		"release:check": "npm run build && npm run typecheck:extras && npm test && npm pack --dry-run && npm run inspect:all",
+		"smoke:live": "tsx scripts/smoke-live.ts",
+		"test": "tsx --test test/*.test.ts",
+		"typecheck": "tsc -p tsconfig.json --noEmit && npm run typecheck:extras",
+		"typecheck:extras": "tsc --ignoreConfig --noEmit --module NodeNext --moduleResolution NodeNext --target ES2022 --strict --skipLibCheck --types node scripts/*.ts test/*.ts"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"yaml": "^2.9.0",
+		"zod": "^3.25.76"
+	},
+	"devDependencies": {
+		"@types/node": "^26.0.1",
+		"tsx": "^4.22.4",
+		"typescript": "^6.0.3"
+	},
+	"engines": {
+		"node": ">=20"
+	}
+}

package/server.json

@@ -0,0 +1,17 @@
+{
+	"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+	"name": "io.github.y2-intel/mcp",
+	"title": "Y2 MCP",
+	"description": "Connect MCP-compatible agents to Y2 docs, OpenAPI, reports, news, and Agent Y2.",
+	"version": "0.1.0",
+	"packages": [
+		{
+			"registryType": "npm",
+			"identifier": "@y2-intel/mcp",
+			"version": "0.1.0",
+			"transport": {
+				"type": "stdio"
+			}
+		}
+	]
+}