Create new agents-mcp package (#1588)

* new agents-mcp package and removal from biome

* checkpoint

* add gh ci action

* chore: add changeset for new @inkeep/agents-mcp package

* fix(ci): add @inkeep/agents-mcp to E2E test build step

The agents-api package depends on @inkeep/agents-mcp, so it needs to be
built before running the integration tests in CI.

* Apply suggestions from code review

Co-authored-by: Dimitri POSTOLOV <dmytropostolov@gmail.com>

* Fix turbo command not found in CI

Use pnpm turbo instead of bare turbo command since turbo is a devDependency, not globally installed.

---------

Co-authored-by: Dimitri POSTOLOV <dmytropostolov@gmail.com>

Author: amikofalvy

.changeset/unified-mcp-server.md

@@ -0,0 +1,5 @@
+---
+"@inkeep/agents-mcp": minor
+---
+
+Add new `@inkeep/agents-mcp` package providing a unified MCP server for AI assistants to interact with the Inkeep Agents platform. This package combines all APIs (manage, run, evals) into a single MCP server, exposing tools for managing agents, projects, tools, credentials, evaluations, datasets, and workflows.

.github/workflows/ci.yml

@@ -200,8 +200,9 @@ jobs:
         run: |
           # Build all packages that the e2e test links to local versions
           # These need dist/ directories for subpath exports like ./factory
-          pnpm --filter @inkeep/agents-core build
+          pnpm turbo run build --filter=@inkeep/create-agents
           pnpm --filter @inkeep/agents-manage-mcp build
+          pnpm --filter @inkeep/agents-mcp build
           pnpm --filter @inkeep/agents-sdk build
           pnpm --filter @inkeep/agents-api build
           pnpm --filter @inkeep/agents-cli build

.github/workflows/speakeasy-sdk.yml

@@ -0,0 +1,21 @@
+name: Speakeasy SDK Generation
+
+on:
+  workflow_dispatch: {} # Manual trigger
+  schedule:
+    - cron: '0 0 * * *' # Daily at midnight UTC
+
+jobs:
+  generate:
+    name: Generate agents-mcp SDK
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate SDK
+        uses: speakeasy-api/sdk-generation-action@v15
+        with:
+          speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
+          github_access_token: ${{ secrets.GITHUB_TOKEN }}
+          mode: pr
+          working_directory: packages/agents-mcp

agents-api/package.json

@@ -59,6 +59,7 @@
     "@hono/zod-openapi": "^1.1.5",
     "@inkeep/agents-core": "workspace:^",
     "@inkeep/agents-manage-mcp": "workspace:^",
+    "@inkeep/agents-mcp": "workspace:^",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@openrouter/ai-sdk-provider": "^1.2.0",
     "@opentelemetry/api": "^1.9.0",

agents-api/src/createApp.ts

@@ -7,6 +7,7 @@ import { evalRoutes } from './domains/evals';
 import { workflowRoutes } from './domains/evals/workflow/routes';
 import { githubRoutes } from './domains/github';
 import { manageRoutes } from './domains/manage';
+import mcpRoutes from './domains/mcp/routes/mcp';
 import { runRoutes } from './domains/run';
 import { env } from './env';
 import { flushBatchProcessor } from './instrumentation';
@@ -365,6 +366,10 @@ function createAgentsHono(config: AppConfig) {
   // Mount GitHub routes - unauthenticated, OIDC token is the authentication
   app.route('/api/github', githubRoutes);
 
+  // Mount MCP routes at top level (eclipses both manage and run services)
+  // Also available at /manage/mcp for backward compatibility
+  app.route('/mcp', mcpRoutes);
+
   // Setup OpenAPI documentation endpoints (/openapi.json and /docs)
   setupOpenAPIRoutes(app);
 

agents-api/src/domains/mcp/routes/mcp.ts

@@ -0,0 +1,57 @@
+import { StreamableHTTPTransport } from '@hono/mcp';
+import {
+  createConsoleLogger,
+  createMCPServer,
+  HeaderForwardingHook,
+  InkeepAgentsCore,
+  SDKHooks,
+} from '@inkeep/agents-mcp';
+import { Hono } from 'hono';
+import { env } from '../../../env';
+
+const app = new Hono();
+
+/**
+ * Headers to forward from incoming requests to downstream API calls.
+ * x-forwarded-cookie is mapped to cookie for browser compatibility
+ * (browsers don't allow setting Cookie header directly).
+ */
+const FORWARDED_HEADERS = ['x-forwarded-cookie', 'authorization', 'cookie'] as const;
+
+app.all('/', async (c) => {
+  const transport = new StreamableHTTPTransport();
+  const noOpLogger = createConsoleLogger('error');
+
+  const headersToForward: Record<string, string> = {};
+  for (const headerName of FORWARDED_HEADERS) {
+    const value = c.req.header(headerName);
+    if (value) {
+      headersToForward[headerName] = value;
+    }
+  }
+
+  if (headersToForward['x-forwarded-cookie'] && !headersToForward.cookie) {
+    headersToForward.cookie = headersToForward['x-forwarded-cookie'];
+  }
+
+  const createSDKWithHeaders = () => {
+    const hooks = new SDKHooks();
+    hooks.registerBeforeRequestHook(new HeaderForwardingHook(headersToForward));
+
+    return new InkeepAgentsCore({
+      serverURL: env.INKEEP_AGENTS_API_URL,
+      hooks,
+    } as any);
+  };
+
+  const mcpServer = createMCPServer({
+    logger: noOpLogger,
+    serverURL: env.INKEEP_AGENTS_API_URL,
+    getSDK: createSDKWithHeaders,
+  });
+
+  await mcpServer.server.connect(transport);
+  return transport.handleRequest(c);
+});
+
+export default app;

biome.json

@@ -19,7 +19,7 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "includes": ["**", "!packages/agents-manage-mcp"]
+    "includes": ["**", "!packages/agents-manage-mcp", "!packages/agents-mcp"]
   },
   "linter": {
     "enabled": true,

packages/agents-mcp/.dxtignore

@@ -0,0 +1,5 @@
+.speakeasy
+.vscode
+bun.lock
+eslint.config.mjs
+node_modules

packages/agents-mcp/.gitattributes

@@ -0,0 +1,2 @@
+# This allows generated code to be indexed correctly
+*.ts linguist-generated=false

packages/agents-mcp/.gitignore

@@ -0,0 +1,13 @@
+**/.speakeasy/logs/
+**/.speakeasy/reports/
+**/.speakeasy/temp/
+/.eslintcache
+/.tsbuildinfo
+/bin
+/esm
+/node_modules
+bun.lock
+.DS_Store
+.env
+.env.local
+*.mcpb