Context Awesome

Official2 toolsLive

by bh-rat · TypeScript

MCP server for accessing curated awesome list documentation

This MCP server provides tools for accessing “curated awesome list” documentation. It is an MCP server focused on retrieving content from curated “awesome list” sources, supporting developers working with LLM and MCP-based agent workflows.

🛠️ Key Features

Exposes 2 tools (toolCount: 2)
Provides access to curated awesome list documentation

🚀 Use Cases

Use with MCP-based agents to fetch documentation from awesome-list collections
Support research and integration work involving LLM and agent systems

⚡ Developer Benefits

Designed for MCP server usage in developer tooling
Aligns with common “awesome-list” documentation formats

⚠️ Limitations

Scope is limited to curated awesome list documentation (no other data sources are described)

Topics

agentsawesomeawesome-listllmmcpmcp-server

Captured live from the server via tools/list.

find_awesome_section

Discovers sections/categories across awesome lists matching a search query and returns matching sections from awesome lists. You MUST call this function before 'get_awesome_items' to discover available sections UNLESS the user explicitly provides a githubRepo or listId. Selection Process: 1. Analyze the query to understand what type of resources the user is looking for 2. Return the most relevant matches based on: - Name similarity to the query and the awesome lists section - Category/section relevance of the awesome lists - Number of items in the section - Confidence score Response Format: - Returns matching sections of the awesome lists with metadata - Includes repository information, item counts, and confidence score - Use the githubRepo or listId with relevant sections from results for get_awesome_items For ambiguous queries, multiple relevant sections will be returned for the user to choose from.

Parameters3

query	string	required	Search terms for finding sections across awesome lists
confidence	number	optional	Minimum confidence score (0-1)
limit	number	optional	Maximum sections to return

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms for finding sections across awesome lists"
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.3,
      "description": "Minimum confidence score (0-1)"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Maximum sections to return"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_awesome_items

Retrieves items from a specific awesome list or section with token limiting. You must call 'find_awesome_section' first to discover available sections, UNLESS the user explicitly provides a githubRepo or listId.

Parameters6

listId	string	optional	UUID of the list (from find_awesome_section results)
githubRepo	string	optional	GitHub repo path (e.g., 'sindresorhus/awesome') from find_awesome_section results
section	string	optional	Category/section name to filter
subcategory	string	optional	Subcategory to filter
tokens	number	optional	Maximum number of tokens to return (default: 10000). Higher values provide more items but consume more tokens.
offset	number	optional	Pagination offset for retrieving more items

Raw schema

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "UUID of the list (from find_awesome_section results)"
    },
    "githubRepo": {
      "type": "string",
      "description": "GitHub repo path (e.g., 'sindresorhus/awesome') from find_awesome_section results"
    },
    "section": {
      "type": "string",
      "description": "Category/section name to filter"
    },
    "subcategory": {
      "type": "string",
      "description": "Subcategory to filter"
    },
    "tokens": {
      "type": "number",
      "description": "Maximum number of tokens to return (default: 10000). Higher values provide more items but consume more tokens."
    },
    "offset": {
      "type": "number",
      "minimum": 0,
      "default": 0,
      "description": "Pagination offset for retrieving more items"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (2)

find_awesome_sectionget_awesome_items

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "context-awesome": {
      "command": "npx",
      "args": [
        "-y",
        "context-awesome@0.1.1"
      ]
    }
  }
}