NCP - Natural Context Provider (NCP) Details

NCP is a unified MCP platform that consolidates 50+ tools, skills, and Photons into a single, intelligent interface. It enables code-mode execution, on-demand loading, scheduling, and semantic tool discovery, dramatically reducing token usage and latency while enabling AI assistants to work with external MCPs, skills, and Photons. This documentation covers how NCP works, the available MCPs and tools, installation and integration steps for popular clients (Claude Desktop, VS Code, and more), and practical examples that demonstrate how to find, run, and compose tools across MCPs. Whether you’re building with internal MCPs or exploring external tools, NCP provides a scalable, vendor-agnostic foundation for AI-powered automation and tool orchestration.

Use Case

NCP acts as a single entry point to discover and execute tools across multiple MCPs, skills, and Photons. It enables semantic tool discovery with the find command, code-mode execution for composing multi-step TypeScript workflows, and run for executing tools individually. It also supports scheduling, so you can automate recurring tasks. Example usage includes discovering the right tool with find, writing a TypeScript workflow with code that calls tools such as web.search and filesystem read_file, and then scheduling that workflow to run on a schedule. Example from docs: const results = await web.search({ query: "Model Context Protocol conference 2025" }); for (const url of results) { const content = await web.read({ url }); } These patterns show how to integrate external MCPs like filesystem, github, brave-search, and web photon capabilities into a cohesive automation and AI-workflow surface.

Available Tools (14)

Examples & Tutorials

Real example code and usage patterns directly from the documentation:

<h1 class="text-2xl font-semibold mt-5 mb-3">Install NCP</h1>
npm install -g @portel/ncp

<h1 class="text-2xl font-semibold mt-5 mb-3">Import existing MCPs (optional)</h1>
ncp config import # Paste your config JSON when prompted

<h1 class="text-2xl font-semibold mt-5 mb-3">Configure your MCP client</h1>
{
"mcpServers": {
"ncp": {
"command": "ncp"
}
}
}

<h1 class="text-2xl font-semibold mt-5 mb-3">Quick Example: General CLI usage</h1>
<h1 class="text-2xl font-semibold mt-5 mb-3">See your imported MCPs</h1>
ncp list

<h1 class="text-2xl font-semibold mt-5 mb-3">Direct testing example from docs</h1>
ncp run filesystem read_file --path "/tmp/test.txt"

// A Real Example from the docs
// Search the web for MCP conferences
const results = await web.search({
query: "Model Context Protocol conference 2025"
});

// Read each result
for (const url of results) {
const content = await web.read({ url });
// Save to ~/.ncp/mcp-conferences.csv
}

<h1 class="text-2xl font-semibold mt-5 mb-3">Scheduling example from docs</h1>
ncp schedule create code:run "every day at 9am" \
--name "MCP Conference Scraper" \
--catchup-missed

Installation Guide

Step-by-step from the documentation:
1) Install NCP globally

npm install -g @portel/ncp

2) Import existing MCPs (optional)
ncp config import  # Paste your config JSON when prompted

3) Configure your MCP client with a sample config:
{
"mcpServers": {
"ncp": {
"command": "ncp"
}
}
}

4) Verify installed tools
ncp list

Integration Guides

Frequently Asked Questions

Is this your MCP?

Claim ownership and get verified badge

Repository Stats

Sponsored

Ad Space Available
Important Notes

Key notes from the docs: - NCP provides a single, unified interface for MCPs, skills, and Photons. - On-demand loading and code-mode execution help reduce token usage and improve responsiveness. - There is an emphasis on vendor-agnostic, plug-and-play MCPs; integrate via the CLI and standard JSON configs. - You can import MCPs, and then configure clients to see only NCP as the tool surface in the AI client.

Prerequisites

Node.js 18+ (Node.js 18.x recommended), npm (included with Node.js) or npx for running packages, and command line access (Terminal on Mac/Linux, Command Prompt/PowerShell on Windows).

Details
Last Updated1/1/2026
Websitegithub.com
SourceGitHub

Compare Alternatives

Similar MCP Tools

9 related tools
Graphiti MCP Server

Graphiti MCP Server

Graphiti MCP Server is an experimental implementation that exposes Graphiti's real-time, temporally-aware knowledge graph capabilities through the MCP (Model Context Protocol) interface. It enables AI agents and MCP clients to interact with Graphiti's knowledge graph for structured extraction, reasoning, and memory across conversations, documents, and enterprise data. The server supports multiple backends (FalkorDB by default and Neo4j), a variety of LLM providers (OpenAI, Anthropic, Gemini, Groq, Azure OpenAI), and multiple embedder options, all accessible via an HTTP MCP endpoint at /mcp/ for broad client compatibility. It also includes queue-based asynchronous episode processing, rich entity types for structured data, and flexible configuration through config.yaml, environment variables, or CLI arguments.

Context7 MCP Server

Context7 MCP Server

Context7 MCP Server delivers up-to-date, code-first documentation and examples for LLMs and AI code editors by pulling content directly from the source. It supports multiple MCP clients and exposes tools that help you resolve library IDs and retrieve library documentation, ensuring prompts use current APIs and usage patterns. The repository provides installation and integration guides for Cursor, Claude Code, Opencode, and other clients, along with practical configuration samples and OAuth options for remote HTTP connections. This MCP server is designed to keep prompts in sync with the latest library docs, reducing hallucinations and outdated code snippets.

TrendRadar MCP

TrendRadar MCP

TrendRadar MCP is an AI-driven Model Context Protocol (MCP) based analysis server that exposes a suite of specialized tools for cross-platform news analysis, trend tracking, and intelligent push notifications. It integrates with TrendRadar’s multi-platform data aggregation (RSS and trending topics) and provides advanced AI-powered insights, sentiment analysis, and cross-platform correlation. The MCP server enables developers to query, analyze, and compare news across platforms using a consistent toolset, with ongoing updates that expand capabilities such as RSS querying, date parsing, and multi-date trend analysis. This documentation references the MCP module updates, tool additions, and architecture changes that enhance extensibility, cross-platform data handling, and AI-assisted reporting.

ChainAware Behavioural Prediction MCP

ChainAware Behavioural Prediction MCP

The ChainAware Behavioural Prediction MCP is an MCP-based server that provides AI-powered tools to analyze wallet behaviour prediction, fraud detection, and rug pull prediction. Designed for Web3 security and DeFi analytics, it enables developers and platforms to integrate risk assessment, predictive wallet behavior insights, and rug-pull detection through MCP-compatible clients. The server exposes three specialized tools and uses Server-Sent Events (SSE) for real-time responses, helping safeguard DeFi users, monitor liquidity risks, and score wallet or contract trustworthiness. Access to production endpoints is API-key gated, reflecting a private backend architecture that supports secure, scalable risk analytics across wallets, contracts, and pools.

Playwright MCP

Playwright MCP

Playwright MCP server. A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables large language models (LLMs) to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models. The server is designed to be fast, lightweight, and deterministic, offering LLM-friendly tooling and a rich set of browser automation capabilities via MCP tools. It supports standalone operation, containerized deployments, and integration with a variety of MCP clients (Claude Desktop, VS Code, Copilot, Cursor, Goose, Windsurf, and others).

Sequential Thinking MCP Server

Sequential Thinking MCP Server

Sequential Thinking MCP Server provides a dedicated MCP tool that guides problem-solving through a structured, step-by-step thinking process. It supports dynamic adjustment of the number of thoughts and allows revision and branching within a controlled workflow, making it ideal for complex analysis and solution hypothesis development. This server is designed to register a single tool, sequential_thinking, and is integrated with common MCP deployment methods (NPX, Docker) as well as editor integrations like Claude Desktop and VS Code for quick setup. The documentation provides exact configuration snippets, usage patterns, and building instructions to help you deploy and use the MCP server effectively, including Codex CLI, NPX, and Docker installation examples.

N8N MCP Server

N8N MCP Server

An MCP (Model Context Protocol) server designed to integrate Claude Desktop, Claude Code, Windsurf, and Cursor with n8n workflows. This MCP enables users to build, test, and orchestrate complex workflows by exposing a set of tools that bridge Claude’s capabilities with n8n’s automation platform. The project emphasizes robust trigger handling, multi-tenant readiness, and progressive documentation to help developers understand how tools map to real-world workflow tasks. It also outlines future tooling integration points (such as getNodeEssentials and getNodeInfo) to further enhance node-structure awareness within MCP-powered automations.

Hugging Face MCP Server

Hugging Face MCP Server

Hugging Face Official MCP Server connects your large language models (LLMs) to the Hugging Face Hub and thousands of Gradio AI Applications, enabling seamless MCP (Model Context Protocol) integration across multiple transports. It supports STDIO, SSE (to be deprecated but still commonly deployed), StreamableHTTP, and StreamableHTTPJson, with the Web Application allowing dynamic tool management and status updates. This MCP server is designed to be run locally or in Docker, and it provides integrations with Claude Desktop, Claude Code, Gemini CLI (and its extension), VSCode, and Cursor, making it easy to configure and manage MCP-enabled tools and endpoints. Tools such as hf_doc_search and hf_doc_fetch can be enabled to enhance document discovery, and an optional Authenticate tool can be included to handle OAuth challenges when called.

Shadcn UI MCP Server v4

Shadcn UI MCP Server v4

Shadcn UI v4 MCP Server is an advanced MCP (Model Context Protocol) server designed to give AI assistants comprehensive access to shadcn/ui v4 components, blocks, demos, and metadata. It enables multi-framework support (React, Svelte, Vue, and React Native) with fast, cache-friendly access to component source code, demos, and directory structures, empowering AI-driven development workflows. The project emphasizes production-readiness with Docker Compose, SSE transport for multi-client deployments, and smart caching to optimize GitHub API usage while providing rich metadata and usage patterns for rapid prototyping and learning across frameworks.