Skip to main content
Context Awesome Logo - Glasses icon representing curated awesome lists

Context Awesome

Give your AI agents access to 7,700+ awesome lists with over 1.2M curated resources.

What are Awesome Lists?
Community-curated collections of the best tools, libraries, and resources on any topic - from ML frameworks to design tools. This MCP server lets your agents recommend high-quality, vetted resources instead of random search results.

7,700+
Awesome Lists
1.2M
Curated Resources
34,000+
Sections

Explore the Index

Every list is extracted into structured, agent-ready data and refreshed automatically. Here's what's inside right now.

ListSourceStarsResourcesUpdated
build-your-own-x

Master programming by recreating your favorite technologies from scratch.

/codecrafters-io/build-your-own-x514k35943 min ago
awesome

😎 Awesome lists about all kinds of interesting topics

/sindresorhus/awesome475k70113 min ago
public-apis

A collective list of free APIs

/public-apis/public-apis440k1.6k23 hours ago
awesome-python

An opinionated list of Python frameworks, libraries, tools, and resources

/vinta/awesome-python302k56523 hours ago
awesome-selfhosted

A list of Free Software network services and web applications which can be hosted on your own servers

/awesome-selfhosted/awesome-selfhosted298k1.3k23 hours ago
the-book-of-secret-knowledge

A collection of inspiring lists, manuals, cheatsheets, blogs, hacks, one-liners, cli/web tools and more.

/trimstray/the-book-of-secret-knowledge227k714 hours ago
computer-science

🎓 Path to a free self-taught education in Computer Science!

/ossu/computer-science205k6823 hours ago
awesome-go

A curated list of awesome Go frameworks, libraries and software

/avelino/awesome-go175k3k23 hours ago
awesome-chatgpt-prompts

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

/f/awesome-chatgpt-prompts163k223 hours ago
free-for-dev

A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev

/ripienaar/free-for-dev123k1.2k23 hours ago

What is Context Awesome?

Context Awesome is a Model Context Protocol (MCP) server that provides instant access to the entire awesome lists ecosystem on GitHub. It enables AI agents to discover and retrieve high-quality, community-curated resources across any domain.

Demo: Using Context Awesome with Claude to find machine learning resources

  • Search across 8,500+ awesome lists with semantic understanding
  • 1mn+ awesome curated resources.
  • Direct integration with Claude, Cursor, and VS Code
  • Token-optimized responses for efficient context usage

Installation

Quick Setup (Hosted Server)

Context Awesome is available as a hosted MCP server. No installation required! Just add the configuration to your MCP client:

Cursor

Settings → Cursor Settings → MCP → Add new global MCP server

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Claude Code

Run in terminal:

claude mcp add --transport http context-awesome https://www.context-awesome.com/api/mcp

Windsurf

Add to MCP config:

{
  "mcpServers": {
    "context-awesome": {
      "serverUrl": "https://www.context-awesome.com/api/mcp"
    }
  }
}

VS Code

Add to settings:

"mcp": {
  "servers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add Custom Connector

  • • Name: Context Awesome
  • • URL: https://www.context-awesome.com/api/mcp

See installation for other MCP clients →

Local Installation (For Development)

1. Clone and Build

git clone https://github.com/bh-rat/context-awesome.git
cd context-awesome
npm install
npm run build

2. Configure for Local Use

Add to your MCP client configuration:

{
  "mcpServers": {
    "context-awesome": {
      "command": "node",
      "args": ["/path/to/context-awesome/build/index.js"],
      "env": {
        "CONTEXT_AWESOME_API_HOST": "https://api.context-awesome.com"
      }
    }
  }
}

3. Run the Server

# Default (stdio transport)
npm run start
# HTTP transport
npm run start -- --transport http --port 3001

Available MCP Tools

find_awesome_section

Discovers sections and categories across awesome lists matching your search query.

Parameters: query, confidence, limit

get_awesome_items

Retrieves items from a specific list or section with token limiting for optimal context usage.

Parameters: listId, section, tokens, offset

Example Queries

"Find the best machine learning resources for Python"

"What are the best resources for authoring technical books?"

"Show me testing tools from awesome-rust"

"Get React component libraries from awesome lists"

"Find database ORMs in Go awesome lists"

Additional Installation Methods

Cline
{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Zed
{
  "context_servers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Augment Code
  1. Click hamburger menu
  2. Select Settings → Tools
  3. Click + Add MCP
  4. Enter URL: https://www.context-awesome.com/api/mcp
Roo Code
{
  "mcpServers": {
    "context-awesome": {
      "type": "streamable-http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Gemini CLI
{
  "mcpServers": {
    "context-awesome": {
      "httpUrl": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Opencode
"mcp": {
  "context-awesome": {
    "type": "remote",
    "url": "https://www.context-awesome.com/api/mcp",
    "enabled": true
  }
}
JetBrains AI Assistant
  1. Settings → Tools → AI Assistant → MCP
  2. Click + Add
  3. Configure URL: https://www.context-awesome.com/api/mcp
Kiro
  1. Navigate Kiro → MCP Servers
  2. Click + Add
  3. Configure URL: https://www.context-awesome.com/api/mcp
Trae
{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Amazon Q Developer CLI
{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Warp
  1. Settings → AI → Manage MCP servers
  2. Click + Add
  3. Configure URL: https://www.context-awesome.com/api/mcp
Copilot Coding Agent
{
  "mcpServers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp",
      "tools": ["find_awesome_section", "get_awesome_items"]
    }
  }
}
LM Studio

Navigate to Program → Install → Edit mcp.json

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
BoltAI
{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Perplexity Desktop
  1. Navigate Settings → Connectors
  2. Click Add Connector → Advanced
  3. Name: Context Awesome
  4. URL: https://www.context-awesome.com/api/mcp
Visual Studio 2022
{
  "inputs": [],
  "servers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Crush
{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Rovo Dev CLI

Run: acli rovodev mcp

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}
Zencoder
  1. Zencoder menu (...) → Agent tools
  2. Click Add custom MCP
  3. Name: Context Awesome
  4. URL: https://www.context-awesome.com/api/mcp
Qodo Gen

Open chat panel → Connect more tools → + Add new MCP

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}