Home / orcaqubits / agentic-commerce-skills-plugins · nlweb-protocol/skills/nlweb-mcp-server/SKILL.md · GitHub

nlweb-mcp-server skillA

nlweb-mcp-server is agent-read markdown (skill) from orcaqubits/agentic-commerce-skills-plugins: Expose NLWeb as an MCP (Model Context Protocol) server — JSON-RPC 2.0 endpoint at /mcp, the `ask` / `list_sites` / `who` tools, protocol revision negotiation, and integration with ChatGPT, Claude, Gemini, and other agent clients. Use when wiring NLWeb to an AI agent via MCP or building an MCP client that consumes an NLWeb site..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# NLWeb MCP Server

## Before writing code

**Fetch live spec**:
1. Fetch https://github.com/nlweb-ai/NLWeb/blob/main/docs/nlweb-rest-api.md (covers `/mcp` route alongside `/ask`).
2. Read `AskAgent/python/webserver/mcp_wrapper.py` in the live repo for the **exact JSON-RPC method list and tool schemas** — these change between releases.
3. Fetch https://github.com/nlweb-ai/NLWeb/blob/main/docs/nlweb-chatgpt-integration.md for the ChatGPT-specific wiring.
4. Fetch https://modelcontextprotocol.io/specification/ — it redirects to the **current** revision. Read the transport rules and the changelog there; never assume a revision from memory.
5. Web-search the latest release notes for any MCP-related changes — the wrapper file's own docstring warns "Backwards compatibility is not guaranteed."

## Conceptual Architecture

### How NLWeb Implements MCP

NLWeb is **already an MCP server** out of the box — same code, second binding. The `/mcp` route in `webserver/routes/mcp.py` accepts JSON-RPC 2.0 requests and re-uses the same `NLWebHandler` pipeline as `/ask`. No separate process, no extra config.

### Routes

| Route | Method | Purpose |
|-------|--------|---------|
…

Read the whole file at its exact version.

How to install

Latest version
mdr add orcaqubits/agentic-commerce-skills-plugins/nlweb-mcp-server@git:20260914.08f85a3
Exact content
mdr add orcaqubits/agentic-commerce-skills-plugins/nlweb-mcp-server@sha256:a72a9a40e6f1fbce

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ug7uuwyvpbf57ll5.svg)](https://markdownregistry.com/a/art_ug7uuwyvpbf57ll5)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260914.08f85a3 latest2026-09-14 08f85a3 9,285 BA view · diff
git:20260513.47510442026-05-13 4751044 7,819 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9285 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

orcaqubits/agentic-commerce-skills-plugins · 39 stars · license MIT · pushed 2026-09-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ug7uuwyvpbf57ll5
GET https://markdownregistry.com/api/v1/resolve?ref=orcaqubits/agentic-commerce-skills-plugins/nlweb-mcp-server
GET https://markdownregistry.com/api/v1/blob/a72a9a40e6f1fbcefbab70d950e2e7deda8f42b74947e2c118ed6d7d2460a85d

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from orcaqubits/agentic-commerce-skills-plugins

a2a-agent-card skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-agent-card/SKILL.md · Create and configure A2A Agent Cards — the discovery document describing an agent's capabilities, skills…
git:20260309.786511c · audit A · 39 stars
a2a-authentication skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-authentication/SKILL.md · Implement A2A authentication — API keys, Bearer tokens, OAuth 2.0, OpenID Connect, and mutual TLS. Use when securing…
git:20260309.786511c · audit A · 39 stars
a2a-client skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-client/SKILL.md · Build an A2A client — the agent-side code that discovers other agents, sends tasks, handles responses, and manages…
git:20260309.786511c · audit A · 39 stars
a2a-dev-patterns skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-dev-patterns/SKILL.md · Apply A2A cross-cutting development patterns — orchestration topologies, idempotency, observability, agent registries…
git:20260309.786511c · audit A · 39 stars
a2a-error-handling skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-error-handling/SKILL.md · Implement A2A error handling — JSON-RPC errors, A2A-specific error codes, task failure states, retry strategies, and…
git:20260309.786511c · audit A · 39 stars
a2a-framework-integration skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-framework-integration/SKILL.md · Integrate A2A with agent frameworks — Google ADK, LangGraph, CrewAI, AutoGen, AWS Bedrock AgentCore, and Microsoft…
git:20260508.a724f54 · audit A · 39 stars
a2a-jsonrpc-transport skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-jsonrpc-transport/SKILL.md · Implement the A2A JSON-RPC 2.0 transport layer — request/response format, method routing, batch requests, and HTTP…
git:20260309.786511c · audit A · 39 stars
a2a-mcp-bridge skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-mcp-bridge/SKILL.md · Build bridges between A2A and MCP — wrap A2A agents as MCP tools, use MCP tools from A2A agents, and architect hybrid…
git:20260309.786511c · audit A · 39 stars
a2a-messages-parts skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-messages-parts/SKILL.md · Implement A2A messages and parts — TextPart, FilePart, DataPart, message roles, metadata, and content negotiation. Use…
git:20260309.786511c · audit A · 39 stars
a2a-multi-turn skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-multi-turn/SKILL.md · Implement A2A multi-turn conversations — input-required state handling, context preservation, iterative refinement, and…
git:20260309.786511c · audit A · 39 stars
a2a-push-notifications skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-push-notifications/SKILL.md · Implement A2A push notifications — callback URL registration, notification delivery, and management methods. Use when…
git:20260309.786511c · audit A · 39 stars
a2a-server skill
orcaqubits/agentic-commerce-skills-plugins · a2a-multi-agent/skills/a2a-server/SKILL.md · Build an A2A server — the agent-side endpoint that receives JSON-RPC requests, processes tasks, manages state, and…
git:20260309.786511c · audit A · 39 stars

Every file in orcaqubits/agentic-commerce-skills-plugins

Browse by kind, by grade A, or by owner.