Skip to main content
Glama

kb-gateway

HTTP MCP gateway for James's learning corpus — Pinecone + Neo4j + agentic router.

Cole — start here (KeyFlo org)

MCP endpoint: https://kb-mcp.waytie.com/mcp

git clone git@github.com:KeyFlo-ai/kb-gateway.git
cd kb-gateway
gh auth login
./scripts/setup-mcp.sh          # pulls KB_GATEWAY_MCP_* from GitHub variables
# paste config/mcp.json → Cursor Settings → MCP

→ Full guide: docs/COLE-SETUP.md · GitHub variable COLE_SETUP points here.

HTTP API (no MCP): KeyFlo-ai/knowledge-base · https://kb-api.keyflo.ai


Audience

Start here

Cole / KeyFlo collaborators

docs/COLE-SETUP.md

Friends (external)

docs/FRIEND-SETUP.md · Request: https://kb-access.waytie.com

External collaborators

James-Server-Admin/kb-gateway

LLMs / agents

AGENTS.md

Discovery

llms.txt

Production: https://kb-mcp.waytie.com/mcp

Related MCP server: kb-gateway

What it does

Remote agents call MCP tools instead of holding Pinecone/Neo4j credentials:

Tool

Purpose

answer_learning_kb

Canonical structured answer — stable wrapper over routing/full-corpus retrieval with sanitized evidence

query_all

Default for broad research — full-corpus search with namespace-tagged sources

route_query

Use when graph vs vector routing matters, or the question is structural/ambiguous

query_namespace

Semantic RAG (patterns, course-transcripts, langchain-docs, research-papers)

graph_query

Neo4j coverage / disputes / topic depth

list_namespaces

Corpus inventory

health

Dependency check

Browser/mobile query page: https://kb-access.waytie.com/query uses the same issued MCP bearer token and returns the answer_learning_kb contract without exposing Pinecone/Neo4j credentials.

For new agents, call answer_learning_kb first. Use intent="broad" for full-corpus research, intent="structural" for coverage/dispute questions, and namespace="research-papers" when external paper evidence is the target. Responses include retrieval_status, evidence.sources, and next_steps; do not make a no-context claim from one empty result.

Quick start (server operator)

source /mnt/blockstorage/env/load.sh kb-gateway
/root/.venv-langchain-course/bin/python -m kb_gateway --transport streamable-http
# binds 127.0.0.1:8790 — public via kb-mcp.waytie.com nginx

Architecture

ARCHITECTURE.md · RUNBOOK.md · docs/client-setup.md

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    F
    maintenance
    HTTP MCP gateway for a learning corpus with Pinecone, Neo4j, and agentic router, enabling remote agents to query via tools like route_query, query_namespace, graph_query, etc.
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    HTTP MCP gateway for a learning corpus that enables remote agents to perform semantic search, graph queries, and routing via Pinecone and Neo4j without direct database credentials.
    -
  • F
    license
    B
    quality
    D
    maintenance
    GraphRAG MCP server for querying SNOM CT medical terminology via Neo4j, offering graph_search_concept and graph_get_related tools to search and traverse concepts and relationships.
    2
    -