@contextbharat/mcp 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# @contextbharat/mcp
+
+MCP server for Indian API documentation.
+
+## Install
+
+```bash
+npx @contextbharat/mcp --api-key YOUR_KEY
+```
+
+## Claude Desktop config
+
+```json
+{
+  "mcpServers": {
+    "contextbharat": {
+      "command": "npx",
+      "args": ["-y", "@contextbharat/mcp", "--api-key", "YOUR_KEY"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm dev          # tsx watch
+pnpm build        # Compile to dist/
+pnpm test         # vitest
+pnpm inspect      # MCP inspector at localhost:5173
+```
+
+## Forked from
+
+[upstash/context7](https://github.com/upstash/context7) (MIT License)

package/dist/client.d.ts

@@ -0,0 +1,48 @@
+export interface ResolveLibraryParams {
+    query: string;
+    libraryName: string;
+}
+export interface ResolveLibraryResult {
+    libraryId: string;
+    name: string;
+    description?: string;
+    versions: string[];
+    tags: string[];
+    confidence: number;
+}
+export interface QueryDocsParams {
+    libraryId: string;
+    query: string;
+    tokenBudget?: number;
+    language?: string;
+}
+export interface QueryDocsResult {
+    docs: string;
+    libraryId: string;
+    libraryName: string;
+    sources: string[];
+    freshnessScore?: number;
+    language: string;
+    tokenCount: number;
+}
+declare class BackendClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor();
+    private get authHeaders();
+    resolveLibrary(params: ResolveLibraryParams): Promise<ResolveLibraryResult>;
+    queryDocs(params: QueryDocsParams): Promise<QueryDocsResult>;
+    listLibraries(category?: string): Promise<{
+        libraries: ResolveLibraryResult[];
+        total: number;
+    }>;
+    private post;
+}
+export declare class BackendError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+export declare const backendClient: BackendClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAOhC,OAAO,KAAK,WAAW,GAItB;IAEK,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAe3E,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAkB5D,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;YAcvF,IAAI;CAkBnB;AAED,qBAAa,YAAa,SAAQ,KAAK;aAEnB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/client.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backendClient = exports.BackendError = void 0;
+/**
+ * HTTP client for the Context Bharat backend API.
+ * Called by MCP tool handlers.
+ */
+const config_js_1 = require("./config.js");
+class BackendClient {
+    baseUrl;
+    apiKey;
+    constructor() {
+        this.baseUrl = config_js_1.config.apiBaseUrl.replace(/\/$/, "");
+        this.apiKey = config_js_1.config.apiKey;
+    }
+    get authHeaders() {
+        return this.apiKey
+            ? { Authorization: `Bearer ${this.apiKey}` }
+            : {};
+    }
+    async resolveLibrary(params) {
+        const raw = await this.post("/v1/libraries/resolve", {
+            query: params.query,
+            library_name: params.libraryName,
+        });
+        return {
+            libraryId: (raw.library_id ?? raw.libraryId),
+            name: raw.name,
+            description: raw.description,
+            versions: (raw.versions ?? []),
+            tags: (raw.tags ?? []),
+            confidence: (raw.confidence ?? 0),
+        };
+    }
+    async queryDocs(params) {
+        const raw = await this.post("/v1/docs/query", {
+            library_id: params.libraryId,
+            query: params.query,
+            token_budget: params.tokenBudget ?? config_js_1.config.defaultTokenBudget,
+            language: params.language ?? "en",
+        });
+        return {
+            docs: (raw.docs ?? ""),
+            libraryId: (raw.library_id ?? raw.libraryId ?? ""),
+            libraryName: (raw.library_name ?? raw.libraryName ?? ""),
+            sources: (raw.sources ?? []),
+            freshnessScore: (raw.freshness_score ?? raw.freshnessScore),
+            language: (raw.language ?? "en"),
+            tokenCount: (raw.token_count ?? raw.tokenCount ?? 0),
+        };
+    }
+    async listLibraries(category) {
+        const url = category
+            ? `${this.baseUrl}/v1/libraries?category=${encodeURIComponent(category)}`
+            : `${this.baseUrl}/v1/libraries`;
+        const response = await fetch(url, {
+            headers: { "Content-Type": "application/json", ...this.authHeaders },
+            signal: AbortSignal.timeout(config_js_1.config.requestTimeoutMs),
+        });
+        if (!response.ok) {
+            throw new BackendError(response.status, await response.text());
+        }
+        return response.json();
+    }
+    async post(path, body) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...this.authHeaders,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(config_js_1.config.requestTimeoutMs),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new BackendError(response.status, errorText);
+        }
+        return response.json();
+    }
+}
+class BackendError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Backend API error ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+        this.name = "BackendError";
+    }
+}
+exports.BackendError = BackendError;
+exports.backendClient = new BackendClient();
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Server configuration.
+ * Reads environment variables at startup.
+ */
+export declare const config: {
+    /** Backend API base URL */
+    readonly apiBaseUrl: string;
+    /** API key for authentication — optional, uses free tier if absent */
+    readonly apiKey: string;
+    /** Default token budget for query-docs */
+    readonly defaultTokenBudget: 5000;
+    /** Request timeout in milliseconds */
+    readonly requestTimeoutMs: 10000;
+    /** Server version */
+    readonly version: "0.1.0";
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB,2BAA2B;;IAE3B,sEAAsE;;IAEtE,0CAA0C;;IAE1C,sCAAsC;;IAEtC,qBAAqB;;CAEb,CAAC"}

package/dist/config.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+/**
+ * MCP Server configuration.
+ * Reads environment variables at startup.
+ */
+exports.config = {
+    /** Backend API base URL */
+    apiBaseUrl: process.env.CONTEXTBHARAT_API_BASE_URL ?? "https://api.contextbharat.com",
+    /** API key for authentication — optional, uses free tier if absent */
+    apiKey: process.env.CONTEXTBHARAT_API_KEY ?? "",
+    /** Default token budget for query-docs */
+    defaultTokenBudget: 5000,
+    /** Request timeout in milliseconds */
+    requestTimeoutMs: 10_000,
+    /** Server version */
+    version: "0.1.0",
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,MAAM,GAAG;IACpB,2BAA2B;IAC3B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,+BAA+B;IACrF,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;IAC/C,0CAA0C;IAC1C,kBAAkB,EAAE,IAAI;IACxB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM;IACxB,qBAAqB;IACrB,OAAO,EAAE,OAAO;CACR,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Context Bharat — MCP Server
+ *
+ * Provides AI coding assistants (Claude, Cursor, VS Code) with up-to-date
+ * documentation for Indian APIs, government specs, and global frameworks.
+ *
+ * Tools:
+ *   - resolve-library-id: map library name → canonical ID
+ *   - query-docs: retrieve relevant documentation chunks
+ *
+ * Transport:
+ *   - PORT env var set  → HTTP Streamable (for Cloud Run / remote hosting)
+ *   - PORT env var unset → stdio (for local npx usage)
+ *
+ * Forked from: upstash/context7 (MIT License)
+ * Backend: Context Bharat proprietary index
+ */
+const node_http_1 = __importDefault(require("node:http"));
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const config_js_1 = require("./config.js");
+const resolve_library_id_js_1 = require("./tools/resolve-library-id.js");
+const query_docs_js_1 = require("./tools/query-docs.js");
+function createServer() {
+    const server = new index_js_1.Server({
+        name: "contextbharat",
+        version: config_js_1.config.version,
+    }, {
+        capabilities: { tools: {} },
+    });
+    // ── Tool definitions ──────────────────────────────────────────────────────────
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "resolve-library-id",
+                description: "Resolve a library or API name to a ContextBharat-compatible library ID. " +
+                    "Always call this before query-docs if you only have a library name. " +
+                    "Supports 100+ Indian APIs (Razorpay, Zerodha, ONDC, UPI, GST) and global frameworks.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "The full user query for context",
+                        },
+                        libraryName: {
+                            type: "string",
+                            description: "The library or API name to resolve",
+                        },
+                    },
+                    required: ["query", "libraryName"],
+                },
+            },
+            {
+                name: "query-docs",
+                description: "Retrieve current documentation for a library. " +
+                    "Returns relevant Markdown documentation within your token budget. " +
+                    "Supports Hindi documentation for Indian APIs (language='hi'). " +
+                    "Use after resolve-library-id to get the libraryId.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        libraryId: {
+                            type: "string",
+                            description: "ContextBharat library ID, e.g. /razorpay/razorpay-sdk",
+                        },
+                        query: {
+                            type: "string",
+                            description: "Developer's specific question or task",
+                        },
+                        tokenBudget: {
+                            type: "number",
+                            description: "Max tokens to return (default 5000)",
+                            default: 5000,
+                        },
+                        language: {
+                            type: "string",
+                            enum: ["en", "hi", "ta", "te", "kn", "bn"],
+                            description: "Documentation language (default: en)",
+                            default: "en",
+                        },
+                    },
+                    required: ["libraryId", "query"],
+                },
+            },
+        ],
+    }));
+    // ── Tool execution ────────────────────────────────────────────────────────────
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            if (name === "resolve-library-id") {
+                const input = resolve_library_id_js_1.resolveLibraryIdSchema.parse(args);
+                result = await (0, resolve_library_id_js_1.resolveLibraryIdHandler)(input);
+            }
+            else if (name === "query-docs") {
+                const input = query_docs_js_1.queryDocsSchema.parse(args);
+                result = await (0, query_docs_js_1.queryDocsHandler)(input);
+            }
+            else {
+                return {
+                    content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: result }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+// ── HTTP mode (Cloud Run) ─────────────────────────────────────────────────────
+async function startHttpServer(port) {
+    // Stateless transport: each POST /mcp gets a fresh transport+server pair.
+    // This is the simplest approach for Cloud Run where instances can be recycled.
+    const httpServer = node_http_1.default.createServer(async (req, res) => {
+        // Health check endpoint — required by Cloud Run
+        if (req.method === "GET" && req.url === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", version: config_js_1.config.version }));
+            return;
+        }
+        // MCP endpoint
+        if (req.url === "/mcp" || req.url === "/") {
+            // Collect request body
+            const chunks = [];
+            req.on("data", (chunk) => chunks.push(chunk));
+            await new Promise((resolve) => req.on("end", resolve));
+            const body = Buffer.concat(chunks).toString("utf-8");
+            let parsedBody;
+            try {
+                parsedBody = body ? JSON.parse(body) : undefined;
+            }
+            catch {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Invalid JSON body" }));
+                return;
+            }
+            // Create a fresh server + transport per request (stateless)
+            const server = createServer();
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined, // stateless
+            });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, parsedBody);
+            return;
+        }
+        // 404 for everything else
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not found" }));
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.listen(port, "0.0.0.0", () => resolve());
+        httpServer.on("error", reject);
+    });
+    process.stderr.write(`Context Bharat MCP server v${config_js_1.config.version} started (HTTP on :${port})\n`);
+}
+// ── stdio mode (local npx) ────────────────────────────────────────────────────
+async function startStdioServer() {
+    const server = createServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`Context Bharat MCP server v${config_js_1.config.version} started (stdio)\n`);
+}
+// ── Entrypoint ────────────────────────────────────────────────────────────────
+async function main() {
+    const portEnv = process.env.PORT;
+    if (portEnv) {
+        const port = parseInt(portEnv, 10);
+        if (isNaN(port)) {
+            throw new Error(`Invalid PORT env var: "${portEnv}"`);
+        }
+        await startHttpServer(port);
+    }
+    else {
+        await startStdioServer();
+    }
+}
+main().catch((error) => {
+    process.stderr.write(`Fatal: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/query-docs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP Tool: query-docs
+ * Retrieves relevant documentation for a library + query.
+ *
+ * Supports:
+ * - Indian fintech APIs (Razorpay, Cashfree, Zerodha, ...)
+ * - India Stack / DPI (ONDC, UPI, GSTN, DigiLocker, ...)
+ * - Global frameworks (React, Next.js, FastAPI, ...)
+ * - Hindi and regional language docs (language parameter)
+ */
+import { z } from "zod";
+export declare const SUPPORTED_LANGUAGES: readonly ["en", "hi", "ta", "te", "kn", "bn"];
+export declare const queryDocsSchema: z.ZodObject<{
+    libraryId: z.ZodString;
+    query: z.ZodString;
+    tokenBudget: z.ZodDefault<z.ZodNumber>;
+    language: z.ZodDefault<z.ZodEnum<["en", "hi", "ta", "te", "kn", "bn"]>>;
+}, "strip", z.ZodTypeAny, {
+    libraryId: string;
+    language: "en" | "hi" | "ta" | "te" | "kn" | "bn";
+    query: string;
+    tokenBudget: number;
+}, {
+    libraryId: string;
+    query: string;
+    language?: "en" | "hi" | "ta" | "te" | "kn" | "bn" | undefined;
+    tokenBudget?: number | undefined;
+}>;
+export type QueryDocsInput = z.infer<typeof queryDocsSchema>;
+export declare function queryDocsHandler(input: QueryDocsInput): Promise<string>;
+//# sourceMappingURL=query-docs.d.ts.map

package/dist/tools/query-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-docs.d.ts","sourceRoot":"","sources":["../../src/tools/query-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB,+CAAgD,CAAC;AAGjF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EA6B1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC7E"}

package/dist/tools/query-docs.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryDocsSchema = exports.SUPPORTED_LANGUAGES = void 0;
+exports.queryDocsHandler = queryDocsHandler;
+/**
+ * MCP Tool: query-docs
+ * Retrieves relevant documentation for a library + query.
+ *
+ * Supports:
+ * - Indian fintech APIs (Razorpay, Cashfree, Zerodha, ...)
+ * - India Stack / DPI (ONDC, UPI, GSTN, DigiLocker, ...)
+ * - Global frameworks (React, Next.js, FastAPI, ...)
+ * - Hindi and regional language docs (language parameter)
+ */
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+exports.SUPPORTED_LANGUAGES = ["en", "hi", "ta", "te", "kn", "bn"];
+exports.queryDocsSchema = zod_1.z.object({
+    libraryId: zod_1.z
+        .string()
+        .describe("ContextBharat-compatible library ID. Use resolve-library-id first if you only have a name. " +
+        "Format: /owner/repo — e.g. /razorpay/razorpay-sdk, /zerodha/kite-api, /ondc/protocol-specs"),
+    query: zod_1.z
+        .string()
+        .describe("The developer's specific question or task. Be specific for better results. " +
+        "E.g. 'create a payment link with expiry' not just 'payment'."),
+    tokenBudget: zod_1.z
+        .number()
+        .min(100)
+        .max(20000)
+        .default(5000)
+        .describe("Maximum number of tokens in the response. Default 5000. " +
+        "Increase for comprehensive guides, decrease for quick references."),
+    language: zod_1.z
+        .enum(exports.SUPPORTED_LANGUAGES)
+        .default("en")
+        .describe("Documentation language. 'hi' for Hindi, 'ta' for Tamil, 'te' for Telugu. " +
+        "Hindi available for top Indian APIs."),
+});
+async function queryDocsHandler(input) {
+    try {
+        const result = await client_js_1.backendClient.queryDocs({
+            libraryId: input.libraryId,
+            query: input.query,
+            tokenBudget: input.tokenBudget,
+            language: input.language,
+        });
+        // Build formatted response
+        const parts = [];
+        // Header with freshness info
+        const freshnessNote = result.freshnessScore !== undefined && result.freshnessScore < 0.5
+            ? ` ⚠️ Note: These docs may be stale (freshness: ${(result.freshnessScore * 100).toFixed(0)}%)`
+            : "";
+        parts.push(`## ${result.libraryName} Documentation${freshnessNote}\n`);
+        // Main content
+        parts.push(result.docs);
+        // Sources
+        if (result.sources.length > 0) {
+            parts.push(`\n---\n**Sources:** ${result.sources.map(s => `[${s}](${s})`).join(" · ")}`);
+        }
+        return parts.join("\n");
+    }
+    catch (error) {
+        if (error instanceof client_js_1.BackendError && error.status === 404) {
+            return [
+                `Library \`${input.libraryId}\` not found or not yet indexed.`,
+                ``,
+                `Check the full library catalog: https://contextbharat.com/libraries`,
+                `If this library should be indexed, open an issue: https://github.com/contextbharat/context-bharat/issues`,
+            ].join("\n");
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=query-docs.js.map

package/dist/tools/query-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-docs.js","sourceRoot":"","sources":["../../src/tools/query-docs.ts"],"names":[],"mappings":";;;AAiDA,4CAuCC;AAxFD;;;;;;;;;GASG;AACH,6BAAwB;AACxB,4CAA2D;AAE9C,QAAA,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAGpE,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,6FAA6F;QAC7F,4FAA4F,CAC7F;IACH,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,6EAA6E;QAC7E,8DAA8D,CAC/D;IACH,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,0DAA0D;QAC1D,mEAAmE,CACpE;IACH,QAAQ,EAAE,OAAC;SACR,IAAI,CAAC,2BAAmB,CAAC;SACzB,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,2EAA2E;QAC3E,sCAAsC,CACvC;CACJ,CAAC,CAAC;AAII,KAAK,UAAU,gBAAgB,CAAC,KAAqB;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,yBAAa,CAAC,SAAS,CAAC;YAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,6BAA6B;QAC7B,MAAM,aAAa,GACjB,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,GAAG,GAAG;YAChE,CAAC,CAAC,iDAAiD,CAAC,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC/F,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,iBAAiB,aAAa,IAAI,CAAC,CAAC;QAEvE,eAAe;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAExB,UAAU;QACV,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAY,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1D,OAAO;gBACL,aAAa,KAAK,CAAC,SAAS,kCAAkC;gBAC9D,EAAE;gBACF,qEAAqE;gBACrE,0GAA0G;aAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/resolve-library-id.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP Tool: resolve-library-id
+ * Maps a human library name to a canonical ContextBharat library ID.
+ *
+ * Example: "zerodha trading api" → "/zerodha/kite-api"
+ */
+import { z } from "zod";
+export declare const resolveLibraryIdSchema: z.ZodObject<{
+    query: z.ZodString;
+    libraryName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    libraryName: string;
+    query: string;
+}, {
+    libraryName: string;
+    query: string;
+}>;
+export type ResolveLibraryIdInput = z.infer<typeof resolveLibraryIdSchema>;
+export declare function resolveLibraryIdHandler(input: ResolveLibraryIdInput): Promise<string>;
+//# sourceMappingURL=resolve-library-id.d.ts.map

package/dist/tools/resolve-library-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-library-id.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-library-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqCjB"}

package/dist/tools/resolve-library-id.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLibraryIdSchema = void 0;
+exports.resolveLibraryIdHandler = resolveLibraryIdHandler;
+/**
+ * MCP Tool: resolve-library-id
+ * Maps a human library name to a canonical ContextBharat library ID.
+ *
+ * Example: "zerodha trading api" → "/zerodha/kite-api"
+ */
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+exports.resolveLibraryIdSchema = zod_1.z.object({
+    query: zod_1.z.string().describe("The full user query or task description. Used to improve resolution accuracy."),
+    libraryName: zod_1.z.string().describe("The library or API name to resolve. E.g. 'razorpay', 'zerodha kite', 'ondc protocol'."),
+});
+async function resolveLibraryIdHandler(input) {
+    try {
+        const result = await client_js_1.backendClient.resolveLibrary({
+            query: input.query,
+            libraryName: input.libraryName,
+        });
+        // Format output for LLM consumption
+        const lines = [
+            `Library resolved: **${result.name}**`,
+            `Library ID: \`${result.libraryId}\``,
+        ];
+        if (result.description) {
+            lines.push(`Description: ${result.description}`);
+        }
+        if (result.tags.length > 0) {
+            lines.push(`Tags: ${result.tags.join(", ")}`);
+        }
+        if (result.versions.length > 0) {
+            lines.push(`Versions: ${result.versions.join(", ")}`);
+        }
+        lines.push(`\nUse \`query-docs\` with libraryId: "${result.libraryId}" to retrieve documentation.`);
+        return lines.join("\n");
+    }
+    catch (error) {
+        if (error instanceof client_js_1.BackendError && error.status === 404) {
+            return [
+                `Library "${input.libraryName}" not found in the Context Bharat index.`,
+                ``,
+                `Try browsing available libraries at https://contextbharat.com/libraries`,
+                `Or contribute a new library: https://github.com/contextbharat/context-bharat/blob/main/docs/CONTRIBUTING.md`,
+            ].join("\n");
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=resolve-library-id.js.map

package/dist/tools/resolve-library-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-library-id.js","sourceRoot":"","sources":["../../src/tools/resolve-library-id.ts"],"names":[],"mappings":";;;AAoBA,0DAuCC;AA3DD;;;;;GAKG;AACH,6BAAwB;AACxB,4CAA2D;AAE9C,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,+EAA+E,CAChF;IACD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAC9B,uFAAuF,CACxF;CACF,CAAC,CAAC;AAII,KAAK,UAAU,uBAAuB,CAC3C,KAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,yBAAa,CAAC,cAAc,CAAC;YAChD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,KAAK,GAAG;YACZ,uBAAuB,MAAM,CAAC,IAAI,IAAI;YACtC,iBAAiB,MAAM,CAAC,SAAS,IAAI;SACtC,CAAC;QACF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,IAAI,CACR,yCAAyC,MAAM,CAAC,SAAS,8BAA8B,CACxF,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAY,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1D,OAAO;gBACL,YAAY,KAAK,CAAC,WAAW,0CAA0C;gBACvE,EAAE;gBACF,yEAAyE;gBACzE,6GAA6G;aAC9G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@contextbharat/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Indian API documentation — Razorpay, Zerodha, ONDC, UPI, and 100+ more",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "contextbharat-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "inspect": "npx @modelcontextprotocol/inspector dist/index.js"
+  },
+  "keywords": ["mcp", "india", "razorpay", "zerodha", "ondc", "documentation", "ai"],
+  "license": "Apache-2.0",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "prettier": "^3.3.0",
+    "eslint": "^9.0.0"
+  }
+}