mcp-sdk-js

[](https://mcp-manifest.dev)

TypeScript SDK for discovering and parsing mcp-manifest.json files. Built for MCP client developers who want to auto-discover, validate, and consume server manifests.

npm install @mcp-manifest/sdk

import { discover } from '@mcp-manifest/sdk';

// From a domain (tries well-known URL, then HTML link tag)
const result = await discover('ironlicensing.com');

// From a direct URL
const result = await discover('https://example.com/mcp-manifest.json');

// From a local file
const result = await discover('./mcp-manifest.json');

if (result.manifest) {
  console.log(`Found via ${result.source}`);
  console.log(result.manifest.server.displayName);
} else {
  console.error('Discovery failed:', result.errors);
}

import { validate } from '@mcp-manifest/sdk';

const { valid, errors } = validate(manifest);

if (!valid) {
  console.error('Validation errors:', errors);
}

import { parse, loadFile } from '@mcp-manifest/sdk';

// Parse a JSON string
const manifest = parse(jsonString);

// Load from a file
const manifest = await loadFile('./mcp-manifest.json');

import { checkCommand } from '@mcp-manifest/sdk';

const exists = await checkCommand('ironlicensing-mcp');

1. If input is a local file path and exists, parse as manifest JSON.
2. If input is a direct URL ending in .json, fetch and parse.
3. Normalize to base URL (prepend https:// if needed).
4. Try well-known URL: GET {base_url}/.well-known/mcp-manifest.json
5. Fetch HTML page, parse for <link rel="mcp-manifest" href="..."> tags.
6. Discovery failed.

The SDK exports full TypeScript types for the manifest spec:

• `McpMani