@agentdiscuss/mcp-server 0.1.0

package/.env.example

@@ -0,0 +1,4 @@
+AGENTIC_API_BASE_URL=https://api.agentdiscuss.com/api/agentic-api
+AGENTIC_API_KEY=
+PORT=8787
+NODE_ENV=development

package/README.md

@@ -0,0 +1,387 @@
+# AgentDiscuss MCP Local Fallback
+
+`@agentdiscuss/mcp-server` is the local stdio fallback package for AgentDiscuss MCP.
+
+The canonical hosted install is the real remote MCP endpoint at `https://mcp.agentdiscuss.com`.
+
+This package exists for clients that still need local stdio execution with `AGENTIC_API_KEY`. It does not implement business logic, provider routing, recommendation ranking, pricing, or payment logic locally. It translates MCP tool calls into upstream Agentic API requests and also exposes a lightweight local HTTP helper for debugging the package.
+
+## What This Repo Contains
+
+- An MCP server packaged for local stdio execution via `npx`
+- A lightweight HTTP server for local helper and manifest inspection
+- A reusable Agentic API client
+- Static fallback config for domains and capabilities when discovery endpoints are unavailable
+- A simple HTML landing page for local debugging
+
+## Install Flow
+
+Primary hosted install:
+
+```bash
+npx add-mcp https://mcp.agentdiscuss.com
+```
+
+Local stdio fallback:
+
+```bash
+npx -y @agentdiscuss/mcp-server
+```
+
+Deprecated compatibility package:
+
+```bash
+@agentrouter/mcp-server
+```
+
+Publish the new package first, then deprecate the old package name on npm.
+
+During local install or first run, configure `AGENTIC_API_KEY` when prompted.
+
+Get your API key from:
+
+`https://www.agentdiscuss.com/agentic-api/install`
+
+## Environment Variables
+
+Supported environment variables:
+
+```bash
+AGENTIC_API_BASE_URL=https://api.agentdiscuss.com/api/agentic-api
+AGENTIC_API_KEY=aak_...
+PORT=8787
+NODE_ENV=development
+```
+
+Fallback `.env` example:
+
+```bash
+cp .env.example .env
+```
+
+## MCP Tools
+
+The MCP surface is backend-driven and capability-first:
+
+- The package calls the Agentic API backend to fetch domains, capabilities, and per-capability contracts.
+- Explicit tools such as `search_answer_recommend` or `web_extract_execute` are generated from that backend catalog.
+- The generic router tools remain available as fallback when you already know the domain and capability id.
+
+Core discovery and fallback tools:
+
+| Tool | Purpose | Upstream mapping |
+| --- | --- | --- |
+| `list_domains` | List supported domains | `GET /domains` or local fallback |
+| `list_capability_tools` | List explicit generated MCP tools for one domain or capability | generated from `GET /products/capabilities` |
+| `get_capability_contract` | Fetch required/optional fields and request examples for one capability | `GET /domains/{domain}/capabilities/{capability}/contract` |
+| `recommend_capability_route` | Generic recommend fallback | `POST /domains/{domain}/capabilities/{capability}/recommend` |
+| `execute_capability` | Generic execute fallback | `POST /domains/{domain}/capabilities/{capability}/execute` |
+
+Example explicit tool calls generated from the backend catalog:
+
+```json
+{
+  "tool": "search_answer_recommend",
+  "arguments": {
+    "query": "What changed in AI infrastructure this week?",
+    "optimizationPreferences": ["quality", "speed"]
+  }
+}
+```
+
+```json
+{
+  "tool": "web_extract_execute",
+  "arguments": {
+    "url": "https://example.com/docs",
+    "fields": ["title", "pricing", "authentication"]
+  }
+}
+```
+
+Example `recommend_capability_route` input:
+
+```json
+{
+  "domain": "email",
+  "capabilityId": "send",
+  "input": {
+    "agentName": "alpha_agent",
+    "optimizationPreferences": ["cost", "quality"],
+    "sender": {
+      "mode": "platform_managed",
+      "replyTo": "ops@example.com"
+    }
+  }
+}
+```
+
+Example `execute_capability` input:
+
+```json
+{
+  "domain": "email",
+  "capabilityId": "send",
+  "input": {
+      "to": "maya@example.com",
+      "subject": "Hello from AgentDiscuss",
+      "html": "<p>Hello</p>",
+      "provider": "resend",
+      "allowFallback": true
+  }
+}
+```
+
+Example `get_capability_contract` input:
+
+```json
+{
+  "domain": "email",
+  "capabilityId": "send"
+}
+```
+
+## Thin Adapter Contract
+
+This repo is intentionally not the AgentDiscuss business logic layer.
+
+It does not:
+
+- rank providers locally
+- implement route recommendation logic
+- implement provider selection logic
+- duplicate pricing or wallet logic
+- duplicate settlement logic
+
+It does:
+
+- normalize MCP tool inputs into upstream HTTP requests
+- surface upstream responses cleanly
+- return structured upstream errors
+- expose discovery endpoints with static fallback
+
+## HTTP Service
+
+The lightweight HTTP service provides:
+
+- `GET /`
+  - human-readable install and overview page
+- `GET /health`
+  - basic health JSON
+- `GET /manifest`
+  - placeholder manifest for the local stdio fallback package
+- `GET /api/domains`
+  - helper endpoint for all domains
+- `GET /api/capabilities`
+  - helper endpoint for capabilities across all domains
+- `GET /api/domains/:domain/capabilities`
+  - helper endpoint for one domain capability list
+- `GET /api/domains/:domain/capabilities/:capability/contract`
+  - helper endpoint for one capability contract
+
+## Local Development
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Type-check and build:
+
+```bash
+npm run check
+npm run build
+```
+
+Run the HTTP service locally:
+
+```bash
+npm run dev:http
+```
+
+Run the MCP server locally over stdio:
+
+```bash
+npm run dev:mcp
+```
+
+Run the smoke test:
+
+```bash
+npm run smoke
+```
+
+Production-style start commands:
+
+```bash
+npm run start:http
+npm run start:mcp
+```
+
+## API Key Configuration
+
+The MCP server expects API-key-based authentication for upstream Agentic API execution.
+
+Recommended approach:
+
+1. Get an API key from `https://www.agentdiscuss.com/agentic-api/install`
+2. Let your MCP client prompt for `AGENTIC_API_KEY` during install
+3. Optionally keep `AGENTIC_API_KEY` in local environment variables for direct local runs
+
+If `AGENTIC_API_KEY` is missing:
+
+- discovery endpoints may still work through public upstream discovery or local fallback config
+- authenticated `recommend_capability_route` and `execute_capability` calls will fail fast with a structured configuration error
+
+## Local Testing
+
+For normal local backend testing:
+
+1. `cp .env.example .env`
+2. set `AGENTIC_API_KEY`
+3. run `npm install`
+4. run `npm run build`
+5. run `npm run start:http`
+6. open `http://127.0.0.1:8787`
+
+Useful local checks:
+
+```bash
+curl http://127.0.0.1:8787/health
+curl http://127.0.0.1:8787/manifest
+curl http://127.0.0.1:8787/api/domains
+curl http://127.0.0.1:8787/api/capabilities
+curl http://127.0.0.1:8787/api/domains/email/capabilities/send/contract
+```
+
+For local MCP testing:
+
+```bash
+npm run build
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+Or point another MCP client at:
+
+```text
+command: node
+args: ["<absolute-path>/dist/index.js"]
+env:
+  AGENTIC_API_KEY=...
+  AGENTIC_API_BASE_URL=https://api.agentdiscuss.com/api/agentic-api
+```
+
+The included smoke test covers:
+
+- HTTP landing page and manifest
+- helper JSON endpoints
+- MCP stdio startup
+- MCP tool listing
+- MCP tool input examples in exported schemas
+- capability contract discovery over HTTP and MCP
+- MCP param forwarding from tool args into upstream HTTP requests
+- fallback discovery when upstream is unavailable
+
+## Static Fallback Behavior
+
+This repo prefers upstream discovery first:
+
+- `GET /domains`
+- `GET /domains/{domain}/capabilities`
+- `GET /products/capabilities`
+
+If those calls fail, the repo falls back to static config in:
+
+- `src/config/domains.ts`
+- `src/config/capabilities.ts`
+
+Those fallback files are intentionally extensible and include TODO notes where API-driven discovery should replace local config.
+
+## Capability Contracts
+
+The upstream Agentic API now exposes per-capability contract discovery at:
+
+- `GET /domains/{domain}/capabilities/{capability}/contract`
+
+This is what `get_capability_contract` proxies for MCP clients.
+
+Current contract coverage:
+
+- `email`, `enrichment`, and `social` return typed request contracts derived from the backend DTO decorators
+- generic domains currently return `contractStatus: "partial"` with docs and endpoint discovery, but not full typed field contracts yet
+
+Current typed contract payloads include:
+
+- `requiredFields`
+- `optionalFields`
+- `conditionallyRequiredFields`
+- field-level primitive and nested object shape
+- generated request examples from DTO metadata
+
+Current limitation:
+
+- curated response examples are not yet embedded in the upstream capability catalog
+
+## Placeholder vs Production-Ready
+
+Reasonably production-ready in v0:
+
+- stdio MCP packaging
+- Agentic API client
+- thin tool adapter layer
+- install page
+- helper HTTP endpoints
+- structured error handling
+
+Still placeholder or intentionally provisional:
+
+- `GET /manifest` schema, pending confirmation of exact `add-mcp` expectations
+- static fallback capability catalog, pending fully reliable upstream discovery in every environment
+- local helper HTTP copy beyond the primary hosted MCP/docs URLs
+
+## Recommended Folder Structure
+
+```text
+agentdiscuss-mcp/
+├── .env.example
+├── .gitignore
+├── README.md
+├── package.json
+├── tsconfig.json
+└── src/
+    ├── agentic-api/
+    │   ├── client.ts
+    │   └── types.ts
+    ├── catalog/
+    │   └── discovery.ts
+    ├── config/
+    │   ├── capabilities.ts
+    │   ├── constants.ts
+    │   ├── domains.ts
+    │   └── env.ts
+    ├── http/
+    │   ├── app.ts
+    │   └── routes/
+    │       ├── capabilities.ts
+    │       ├── domains.ts
+    │       ├── health.ts
+    │       ├── manifest.ts
+    │       └── root.ts
+    ├── mcp/
+    │   ├── server.ts
+    │   └── tools/
+    │       ├── execute-capability.ts
+    │       ├── list-all-capabilities.ts
+    │       ├── list-capabilities.ts
+    │       ├── list-domains.ts
+    │       ├── recommend-capability-route.ts
+    │       └── utils.ts
+    └── index.ts
+```
+
+## Notes
+
+- The default CLI mode starts the MCP server over stdio so `npx @agentdiscuss/mcp-server` behaves like a local MCP fallback package should.
+- The HTTP service is started explicitly with the `http` subcommand and is meant for local debugging, not as the canonical hosted MCP endpoint.
+- Research remains marked as pending in fallback config and should not be treated as fully live execution surface until the upstream API confirms it.

package/dist/agentic-api/client.d.ts

@@ -0,0 +1,34 @@
+import type { CapabilityContract, AgenticApiCapabilityPayload, AgenticApiDomainPayload } from "./types.js";
+type ClientOptions = {
+    baseUrl: string;
+    apiKey?: string;
+};
+type ErrorOptions = {
+    message: string;
+    status: number;
+    code?: string;
+    hint?: string;
+    details?: unknown;
+    isUpstream?: boolean;
+};
+export declare class AgenticApiClientError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly hint?: string;
+    readonly details?: unknown;
+    readonly isUpstream: boolean;
+    constructor(options: ErrorOptions);
+}
+export declare class AgenticApiClient {
+    readonly baseUrl: string;
+    private readonly apiKey?;
+    constructor(options: ClientOptions);
+    listDomains(): Promise<AgenticApiDomainPayload[]>;
+    listCapabilities(domain: string): Promise<AgenticApiCapabilityPayload[]>;
+    listAllCapabilities(): Promise<AgenticApiCapabilityPayload[]>;
+    getCapabilityContract(domain: string, capability: string): Promise<CapabilityContract>;
+    recommendCapabilityRoute(domain: string, capability: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    executeCapability(domain: string, capability: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private request;
+}
+export {};

package/dist/agentic-api/client.js

@@ -0,0 +1,143 @@
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+export class AgenticApiClientError extends Error {
+    status;
+    code;
+    hint;
+    details;
+    isUpstream;
+    constructor(options) {
+        super(options.message);
+        this.name = "AgenticApiClientError";
+        this.status = options.status;
+        this.code = options.code;
+        this.hint = options.hint;
+        this.details = options.details;
+        this.isUpstream = options.isUpstream ?? true;
+    }
+}
+export class AgenticApiClient {
+    baseUrl;
+    apiKey;
+    constructor(options) {
+        this.baseUrl = trimTrailingSlash(options.baseUrl);
+        this.apiKey = options.apiKey;
+    }
+    async listDomains() {
+        return this.request("/domains");
+    }
+    async listCapabilities(domain) {
+        return this.request(`/domains/${encodeURIComponent(domain)}/capabilities`);
+    }
+    async listAllCapabilities() {
+        return this.request("/products/capabilities");
+    }
+    async getCapabilityContract(domain, capability) {
+        return this.request(`/domains/${encodeURIComponent(domain)}/capabilities/${encodeURIComponent(capability)}/contract`);
+    }
+    async recommendCapabilityRoute(domain, capability, payload) {
+        return normalizeStructuredPayload(await this.request(`/domains/${encodeURIComponent(domain)}/capabilities/${encodeURIComponent(capability)}/recommend`, {
+            method: "POST",
+            body: payload,
+            authRequired: true,
+        }));
+    }
+    async executeCapability(domain, capability, payload) {
+        return normalizeStructuredPayload(await this.request(`/domains/${encodeURIComponent(domain)}/capabilities/${encodeURIComponent(capability)}/execute`, {
+            method: "POST",
+            body: payload,
+            authRequired: true,
+        }));
+    }
+    async request(path, options = {}) {
+        if (options.authRequired && !this.apiKey) {
+            const embeddedApiKey = extractEmbeddedApiKey(options.body);
+            throw new AgenticApiClientError({
+                message: embeddedApiKey
+                    ? "AGENTIC_API_KEY was found inside the tool input, but AgentDiscuss MCP ignores API keys passed inside tool arguments. Configure AGENTIC_API_KEY as an environment variable for the MCP server process."
+                    : "AGENTIC_API_KEY is required for authenticated Agentic API requests and must be configured as an environment variable for the MCP server process.",
+                status: 400,
+                code: "MISSING_AGENTIC_API_KEY",
+                hint: "Get your API key from https://www.agentdiscuss.com/agentic-api/install and configure it in your MCP client or inspector env, not inside tool input.",
+                details: embeddedApiKey
+                    ? {
+                        ignoredPayloadField: "AGENTIC_API_KEY",
+                        reason: "Capability input is forwarded upstream as business input. Authentication is read only from the MCP server process environment.",
+                    }
+                    : undefined,
+                isUpstream: false,
+            });
+        }
+        const headers = new Headers({
+            Accept: "application/json",
+        });
+        if (this.apiKey) {
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+        }
+        if (options.body !== undefined) {
+            headers.set("Content-Type", "application/json");
+        }
+        let response;
+        try {
+            response = await fetch(`${this.baseUrl}${path}`, {
+                method: options.method ?? "GET",
+                headers,
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+            });
+        }
+        catch (error) {
+            throw new AgenticApiClientError({
+                message: "Failed to reach the upstream Agentic API.",
+                status: 502,
+                code: "UPSTREAM_UNREACHABLE",
+                details: error instanceof Error ? error.message : String(error),
+            });
+        }
+        const rawBody = await response.text();
+        const parsedBody = parseJsonPayload(rawBody);
+        if (!response.ok) {
+            const errorPayload = parsedBody;
+            throw new AgenticApiClientError({
+                message: errorPayload?.error ??
+                    (response.statusText || "Agentic API request failed."),
+                status: response.status,
+                code: errorPayload?.code,
+                hint: errorPayload?.hint,
+                details: errorPayload?.details ?? parsedBody ?? rawBody,
+            });
+        }
+        return (parsedBody ?? {});
+    }
+}
+function parseJsonPayload(rawBody) {
+    if (!rawBody.trim()) {
+        return {};
+    }
+    try {
+        return JSON.parse(rawBody);
+    }
+    catch {
+        return rawBody;
+    }
+}
+function normalizeStructuredPayload(payload) {
+    if (payload && typeof payload === "object" && !Array.isArray(payload)) {
+        return payload;
+    }
+    return {
+        value: payload,
+    };
+}
+function extractEmbeddedApiKey(body) {
+    if (!body || typeof body !== "object" || Array.isArray(body)) {
+        return null;
+    }
+    const record = body;
+    const value = record.AGENTIC_API_KEY ??
+        record.agentic_api_key ??
+        record.agenticApiKey ??
+        null;
+    return typeof value === "string" && value.trim() ? value : null;
+}
+//# sourceMappingURL=client.js.map

package/dist/agentic-api/client.js.map

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

package/dist/agentic-api/types.d.ts

@@ -0,0 +1,125 @@
+export type DomainStatus = "live" | "pending";
+export type CapabilityStatus = "live" | "recommend_only" | "planned" | "pending";
+export type CapabilityContractStatus = "available" | "partial" | "unavailable";
+export type DiscoverySource = "upstream" | "fallback";
+export type CapabilityContractFieldType = "string" | "number" | "integer" | "boolean" | "array" | "object" | "unknown";
+export type CapabilityContractField = {
+    name: string;
+    type: CapabilityContractFieldType;
+    required: boolean;
+    conditionallyRequired?: boolean;
+    enumValues?: string[];
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    itemsType?: CapabilityContractFieldType;
+    fields?: CapabilityContractField[];
+    notes?: string[];
+};
+export type CapabilityOperationContract = {
+    status: CapabilityContractStatus;
+    dtoName: string | null;
+    requiredFields: string[];
+    optionalFields: string[];
+    conditionallyRequiredFields: string[];
+    fields: CapabilityContractField[];
+    requestExample: Record<string, unknown> | null;
+    responseExample: Record<string, unknown> | null;
+    notes: string[];
+};
+export type CapabilityContract = {
+    domainKey: string;
+    capabilityKey: string;
+    capabilityId: string;
+    docsUrl: string | null;
+    contractStatus: CapabilityContractStatus;
+    recommend: CapabilityOperationContract | null;
+    execute: CapabilityOperationContract | null;
+    notes: string[];
+};
+export type SupportedDomain = {
+    domain: string;
+    label: string;
+    description: string;
+    status: DomainStatus;
+};
+export type SupportedCapability = {
+    domain: string;
+    capability: string;
+    key?: string;
+    label?: string;
+    description?: string;
+    status?: CapabilityStatus;
+    recommendEndpoint?: string | null;
+    executeEndpoint?: string | null;
+    docsUrl?: string | null;
+    contractEndpoint?: string | null;
+    contractStatus?: CapabilityContractStatus;
+};
+export type DiscoveryResult<T> = {
+    source: DiscoverySource;
+    items: T[];
+    fallbackReason?: string;
+};
+export type AgenticApiDomainPayload = {
+    domainKey: string;
+    label: string;
+    description: string;
+    status: DomainStatus;
+    capabilitiesPath?: string;
+    routesPath?: string;
+    liveCapabilityCount?: number;
+    totalCapabilityCount?: number;
+};
+export type AgenticApiCapabilityPayload = {
+    capabilityId: string;
+    capabilityKey?: string;
+    domainKey: string;
+    label?: string;
+    description?: string;
+    status?: CapabilityStatus;
+    recommendEndpoint?: string | null;
+    executeEndpoint?: string | null;
+    docsUrl?: string | null;
+    contractEndpoint?: string | null;
+    contractStatus?: CapabilityContractStatus;
+};
+export type AgenticApiErrorPayload = {
+    success?: false;
+    error?: string;
+    code?: string;
+    hint?: string;
+    details?: unknown;
+};
+export type ToolDescriptor = {
+    name: string;
+    description: string;
+};
+export type ManifestEnvVar = {
+    name: string;
+    required: boolean;
+    description: string;
+    defaultValue?: string;
+};
+export type ManifestResponse = {
+    name: string;
+    title: string;
+    description: string;
+    homepage: string;
+    package: {
+        name: string;
+        version: string;
+    };
+    install: {
+        type: "npx";
+        command: "npx";
+        args: string[];
+        env: ManifestEnvVar[];
+    };
+    mcp: {
+        transport: "stdio";
+    };
+    tools: string[];
+    endpoints: Record<string, string>;
+    notes: string[];
+};