CliDeck MCP — Network Knowledge

com.clideckPublished by clideck.comOfficial publisherv0.8.5Updated Nov 2, 2026

Free verified network knowledge for AI agents: deterministic answers, honest unknowns.

VerifiedStreamable HTTPWeb executableCloud & InfrastructureKnowledge & Memory

Overview

AI-generated overview

Remote MCP endpoint giving assistants deterministic, version-scoped network knowledge: commands, diagnostics, workflows, change review and expert research…

What you can do
  • Resolve vendor, model, OS and version context, then query version-scoped commands, diagnostics and concepts
  • List and describe installed knowledge domain packs and run deterministic domain searches
  • Get ordered workflows with safety, verification and rollback, plus provenance metadata for revisions
  • Review and verify proposed network changes, advise on upgrades, and analyze device snapshots or path/topology output
  • Report knowledge gaps, submit feedback, and create, poll, continue or cancel expert research tasks
When to use it
Useful when an assistant needs source-backed, version-specific networking guidance — device commands, troubleshooting, change review or upgrade planning — and should say "unknown" rather than guess. Also fits teams that want to file research tasks for gaps in the knowledge base.
Requirements
A Streamable HTTP MCP client pointed at the hosted endpoint; no authentication, environment variables or headers are declared. Running the open-source version locally needs Node.js 24, pnpm and PostgreSQL 16.
Before you install
The service is advisory only and never connects to devices or executes commands. Device snapshots and path outputs are described as redacted and not stored, but they are still sent to a third-party service. Queries and gap reports create tracked research demands, and expert tasks return an access token that must be kept private. Coverage varies by vendor, platform and version.

Installation

In SourceWeft

  1. Open CliDeck MCP — Network Knowledge in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.clideck%2Fnetwork-knowledge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "clideck-network-knowledge": {
      "type": "http",
      "url": "https://mcp.clideck.com/mcp"
    }
  }
}

README

CliDeck MCP

An open-source framework for version-aware, source-backed knowledge that AI agents query through MCP. Known answers use deterministic PostgreSQL retrieval; incomplete answers create durable research demands. Isolated Codex runs discover and extract evidence; the core validates and publishes immutable revisions. CliDeck provides guidance and never connects to devices or executes commands.

SurfaceURL
Public Streamable HTTP MCPhttps://mcp.clideck.com/mcp
Network Evidence Workbenchhttps://mcp.clideck.com/webmcp
Live read-only operations demohttps://mcp.clideck.com/demo
Product pagehttps://clideck.com/software/mcp

Capabilities

  • Network Knowledge: device context, commands, workflows, snapshots and redaction, change review, verification, upgrades, topology and expert tasks. Exact context ranks first; broader guidance is labelled and unsupported questions remain unknown. Coverage varies by vendor, platform and version.
  • Domain Packs: subject-specific schemas and deterministic validation over the shared revision/release core. Engineering Measurements demonstrates exact decimal values, units and tolerances outside networking.
  • Continuous research: 1–8 enabled isolated executors, independent Luna/High models and official price comparison in /admin/models; downloads, conversion, OCR, chunking, indexing and publication are mechanical. AI receives bounded tasks through the researcher bridge. See model policy.
  • WebMCP: six typed browser tools share a versioned case with the engineer. Complete files stay local; selected evidence is redacted before transmission. Browser-agent evidence access requires explicit opt-in. Manual controls work without WebMCP. See contract and walkthrough.
  • Operations demo: /admin and /demo use the same frontend and real production counters. Server-side projections redact private data; demo controls cannot mutate production.

[Production operations dashboard]

Live totals are available in the demo and /public/v1/stats; historical counts and test results are not current service guarantees. Codex was the primary engineering environment. Pipeline use through a local authenticated Codex installation needs no separate model API integration and remains subject to plan and usage limits.

Run locally

Requirements: Node.js 24, pnpm as pinned in package.json, PostgreSQL 16 (Docker Compose is provided).

bash
cp .env.example .envset -asource .envset +apnpm install --frozen-lockfiledocker compose up -d postgrespnpm db:migratepnpm db:seedpnpm knowledge:reindex-applicability -- --resume --verifypnpm buildpnpm dev:api

Edit .env for your local database before sourcing it. MCP listens at http://127.0.0.1:8787/mcp. Worker/researcher entry points and all supported commands are in package.json. Production uses the canonical deployment workflow.

To connect the hosted service with the Codex CLI:

bash
codex mcp add clideck --url https://mcp.clideck.com/mcpcodex mcp list

Other Streamable HTTP MCP clients can use the same endpoint.

Develop

bash
pnpm checkpnpm testpnpm evalpnpm build

PostgreSQL integration tests and the 250-case evaluation need a migrated, seeded test database. A run that skips DB tests is not full release validation; the deploy script provisions its own disposable database and applies grants.

Create a pack:

bash
pnpm domain:create -- --id marine-science --name "Marine Science"pnpm install --lockfile-onlypnpm domain:validate -- --id marine-sciencepnpm --filter @clideck/domain-marine-science test

See agent rules, documentation map, architecture, pack authoring and security.

License and privacy

Apache-2.0 covers code and project-authored fixtures, not production knowledge, third-party manuals or user data. Internal evidence and secrets stay private. The dedicated provenance tool exposes only allowlisted metadata for active revisions; the operations demo retains its stricter redaction boundary. See DATA-NOTICE.md.

Source: README.md at commit 828aa3b

Tools

20

report_knowledge_gap

Report an Incomplete or Incorrect Answer

Record the original network question for priority research. Provide missing context or explain why an answer was not useful. Feedback alone does not change or quarantine published knowledge.

Parametersreasonrequiredcontextquestionrequiredrevision_refs

report_domain_knowledge_gap

Report an Incomplete Technical Answer

Retain the original technical question, independent OS/component versions and missing details for priority learning. Does not alter published revisions.

Parametersreasonrequiredcontextrequiredquestionrequireddomain_idrequiredrevision_refs

get_learning_status

Get Learning Progress

Check a learning ID returned by a knowledge query or report_knowledge_gap. Published means the original question has a complete answer; repeat the original query to read it.

Parameterslearning_idrequired

list_knowledge_domains

List Knowledge Domains

List installed, compatible knowledge domain packs and their declared capabilities.

Takes no parameters.

describe_knowledge_domain

Describe Knowledge Domain

Return the context and public-record contracts for one installed knowledge domain.

Parametersdomain_idrequired

query_domain_knowledge

Query Domain Knowledge

Run deterministic search in one domain using that pack’s validated context and public-record schema. Network queries may create or update a tracked research demand for missing or incomplete knowledge.

Parameterslimitcontextrequiredquestionrequireddomain_idrequired

resolve_network_context

Resolve Network Context

Resolve vendor, model/platform, portable software family, operating system, and version context.

Parametersmodelvendorversionruntime_modeoperating_systemshell_environment

query_network_knowledge

Query Network Knowledge

Return deterministic, version-scoped commands, diagnostics, and concepts for a network question. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

Parameterslimitcontextrequiredquestionrequired

get_knowledge_provenance

Get Knowledge Provenance

Return safe source metadata for up to five active knowledge revisions.

Parametersrevision_refsrequired

get_network_workflow

Get Network Workflow

Return a deterministic, ordered workflow including safety, verification, and rollback. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

Parametersgoalrequiredlimitcontextrequired

request_expert_answer

Request Expert Answer

Create a durable research task when deterministic knowledge has no applicable answer.

Parameterscontextrequiredquestionrequiredidempotency_key

get_expert_task

Get Expert Task

Poll an expert research task by opaque ID and access token.

Parameterstask_idrequiredaccess_token

continue_expert_task

Continue Expert Task

Provide bounded additional input requested by the researcher.

Parametersmessagerequiredtask_idrequiredaccess_token

cancel_expert_task

Cancel Expert Task

Cancel a non-terminal expert task.

Parameterstask_idrequiredaccess_token

submit_feedback

Submit Feedback

Submit correctness, freshness, safety, or completeness feedback without including private logs.

Parametersratingcommenttask_idcategoryrequiredaccess_tokenrevision_refsample_contribution

analyze_device_snapshot

Analyze Device Snapshot

Detect vendor, model, operating system, and version from bounded CLI output while redacting sensitive values. Input is not stored.

Parameterssnapshotrequiredsnapshot_typeredaction_profile

review_network_change

Review Network Change

Deterministic advisory review of commands or a configuration diff. It always returns available guidance and never executes a command. Missing or incomplete knowledge may create or update a tracked research demand.

Parametersintentrequiredcontextrequiredcommandsconfig_diff

verify_network_change

Verify Network Change

Evaluate bounded before/after outputs against the signed verification plan returned by review_network_change.

Parametersafter_snapshotrequiredbefore_snapshotrequiredverification_tokenrequired

advise_network_upgrade

Advise Network Upgrade

Return exact-model, exact-version upgrade prerequisites, risks, checks, and rollback without downloading software. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

Parametersmodelrequiredtarget_versionrequiredcurrent_versionrequiredenabled_featuresoperating_system

analyze_network_path

Analyze Network Path

Build a bounded topology and packet-path graph from supplied CDP, LLDP, route, and traceroute outputs without storing them.

Parameterssourcesnapshotsrequireddestination

Version history

1
  1. v0.8.5LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts