mcp-astgl-knowledge

An MCP server that lets AI assistants search and cite content from As The Geek Learns — covering MCP servers, local AI, AI automation, and ASTGL project documentation.

When an AI assistant connects to this server, it gains access to 49 indexed entries (articles, tutorials, comparisons, guides, and project docs). Every response includes source URLs back to astgl.ai.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"]
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"]
    }
  }
}

Cursor / Generic MCP Client

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"]
    }
  }
}

With Registration (500 queries/day)

Register via the register tool to get an API key, then add it to your config:

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"],
      "env": {
        "ASTGL_API_KEY": "astgl_your_api_key_here"
      }
    }
  }
}

Tools

search_articles

Search the knowledge base by query. Returns ranked results with relevance scores and source URLs.

Parameter	Type	Required	Description
query	string	Yes	Search query (e.g., "how to build an MCP server")
limit	number	No	Max results, 1-20 (default: 5)
content_type	string	No	Filter by type: article, tutorial, faq, comparison, guide, newsletter, project

get_answer

Get a direct answer to a specific question. Prefers FAQ entries for concise responses.

Parameter	Type	Required	Description
question	string	Yes	A specific question (e.g., "What is an MCP server?")
content_type	string	No	Filter by content type

get_tutorial

Get step-by-step instructions from tutorial and guide content.

Parameter	Type	Required	Description
query	string	Yes	What you want to learn (e.g., "setup Ollama on Mac")

compare_topics

Side-by-side comparison of two topics.

Parameter	Type	Required	Description
topic_a	string	Yes	First topic
topic_b	string	Yes	Second topic

get_latest

Get the most recently added content.

Parameter	Type	Required	Description
limit	number	No	Max results, 1-20 (default: 5)

list_topics

Browse all topics in the knowledge base with content types and section headings.

register

Register your email to unlock 500 queries/day (up from 50).

Parameter	Type	Required	Description
email	string	Yes	Your email address

Content Types

Type	Count	Description
article	29	Informational content about MCP, local AI, automation
project	9	ASTGL project documentation (KlockThingy, Revri, Cortex, etc.)
tutorial	8	Step-by-step how-to guides
comparison	2	Side-by-side topic analysis
guide	1	Comprehensive reference material
newsletter	—	Personal updates and announcements
faq	—	Primarily Q&A content

Rate Limits

Tier	Limit	How to Get
Public	50 queries/day	Default (anonymous)
Registered	500 queries/day	Use the register tool with your email

Limits reset at midnight UTC. Rate limit info is included in every response.

How It Works

The knowledge base is pre-built from ASTGL articles using

... View full README on GitHub