eds-mcp-server: Instructions file for Claude Code

EDS MCP Server

MCP server for Adobe Edge Delivery Services. Provides 41 tools for AI agents to manage EDS sites: preview, publish, bulk operations, search, redirects, read content, query metrics, and configure sites.

Architecture

Follows Adobe's MCP conventions (derived from adobe-rnd/da-mcp):

• TypeScript + @modelcontextprotocol/sdk + zod
• Stateless per-request
• Tool naming: eds_{verb}_{noun}
• Stdio transport for local use (Claude Code, Cursor)

Project Structure

src/
  index.ts              -- Entry point, reads env vars, connects stdio transport
  mcp/
    server.ts           -- McpServer factory, all 41 tool registrations with Zod schemas
    handlers.ts         -- One async function per tool
  eds-admin/
    client.ts           -- HTTP client wrapping all EDS APIs
    types.ts            -- TypeScript interfaces
  utils/
    errors.ts           -- Error formatting + typed EdsApiError
  lib.ts                -- Import-safe public library surface (main/types entry)

Environment Variables

Variable	Required	Description
EDS_OWNER	Yes	GitHub org/owner for the EDS site
EDS_REPO	Yes	GitHub repo name
EDS_REF	No	Git ref (default: main)
EDS_API_KEY	No	Admin API token override (see Authentication). Browser login is the alternative for interactive use.
EDS_DOMAIN_KEY	No	OpTel domain key (required for CWV/404/experiment queries)
EDS_DA_TOKEN	No	Document Authoring API token (required for eds_da_* tools)
EDS_DA_ORG	No	DA org (defaults to EDS_OWNER)
EDS_DA_REPO	No	DA repo/site (defaults to EDS_REPO)

Authentication

Admin operations require an EDS Admin token, resolved at request time by src/auth/getValidToken:

1. EDS_API_KEY override — if set, always used (bypasses cache). Keeps CI / automation working unchanged.
2. Cached browser-login token — ~/.aem/auth-token.json, used when valid (not within 60s of expiry) and owner/repo match.
3. Otherwise a NeedsLoginError surfaces as a friendly MCP error: "Run npx @focusgts/eds-mcp-server login to sign in."