Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mcpkit.sh/llms.txt

Use this file to discover all available pages before exploring further.

This section contains examples of MCP servers generated with MCPKit for different types of websites and use cases.

​
Example Categories

Content Platforms

Hacker News - News aggregation and discussions

Coming Soon: Social Media

Reddit, Twitter/X - Social platforms

Coming Soon: E-commerce

Shopping sites and marketplaces

​
What You’ll Learn

Each example includes:
  • Setup instructions - How to generate the MCP server
  • Authentication guide - Handling login if required
  • Available tools - What the AI can do with the site
  • Usage examples - Real prompts and expected results
  • Customization tips - How to extend the generated server

​
Quick Examples

​
1. Hacker News (No Auth Required)

Generate an MCP server for browsing and searching Hacker News: 
mcpkit create https://news.ycombinator.com
What you can do:
  • Search for articles about specific topics
  • Get top stories
  • Read article comments
  • Find trending discussions
Example usage: 
User: Search Hacker News for articles about AI safety
AI: [Uses search_articles tool with query "AI safety"]

​
2. Substack (Content Platform)

Generate an MCP server for the Substack newsletter platform: 
mcpkit create https://substack.com
What you can do:
  • Search for publications by topic
  • Read newsletter posts
  • Browse trending content
  • View author profiles
Example usage: 
User: Find tech newsletters about AI and show me their latest posts
AI: [Uses search_publications and read_post tools]

​
3. GitHub (Public + Private)

Generate an MCP server for GitHub: 
mcpkit create https://github.com
What you can do:
  • Search repositories
  • View issues and pull requests
  • Read file contents
  • Check commit history
Example usage: 
User: Find React repositories with over 10k stars
AI: [Uses search_repositories tool with filters]

​
Example Workflows

​
Research & Monitoring

Use multiple MCP servers together to gather information: 
# Set up servers for different sources
mcpkit create https://news.ycombinator.com
mcpkit create https://github.com
mcpkit create https://reddit.com

# Then ask Claude to:
# "Search HN, GitHub, and Reddit for discussions about NextJS 14"

​
Project Management Automation

Automate your workflow across tools: 
# Set up authenticated sites
mcpkit contexts create mcpkit.sh
mcpkit contexts create github.com

mcpkit create https://mcpkit.sh --skip-auth
mcpkit create https://github.com --skip-auth

# Then ask Claude to automate workflows across platforms

​
Content Curation

Gather and organize content from multiple sources: 
mcpkit create https://news.ycombinator.com
mcpkit create https://medium.com
mcpkit create https://dev.to

# Then ask Claude to:
# "Find the top 5 articles about React Hooks from HN, Medium, and DEV"
Type: Public + Authenticated (for premium content)Use Case: Content discovery, newsletter aggregation, researchKey Features:
  • Search publications by topic
  • Read posts and articles
  • Browse trending content
  • View author profiles
Authentication: Optional (required for subscriber-only content)View Full Example →
Type: Public, No AuthUse Case: News discovery, trend monitoring, researchKey Features:
  • Search articles by keyword
  • Get top stories
  • Read comments and discussions
  • Filter by date and score
Authentication: Not requiredView Full Example →
Type: Enterprise, AuthenticatedUse Case: Knowledge base search, documentationKey Features:
  • Search documentation
  • Read page contents
  • Navigate page hierarchy
  • Extract structured data
Authentication: Required (SSO, credentials)Note: For internal tools, ensure you have authorization to automate access.
Type: Public/AuthenticatedUse Case: Product research, price monitoring, inventory checkingKey Features:
  • Search products
  • Get product details
  • Check availability
  • Compare prices
Authentication: Optional (for account features)

​
Best Practices from Examples

​
1. Start Simple

Begin with public websites that don’t require authentication: 
# Good first examples
mcpkit create https://news.ycombinator.com
mcpkit create https://producthunt.com
mcpkit create https://reddit.com

​
2. Save Authentication Contexts

For sites you use frequently, save contexts: 
# Authenticate once
mcpkit create https://mcpkit.sh

# Reuse later
mcpkit create https://mcpkit.sh --skip-auth

​
3. Test Individual Tools

Use the MCP Inspector to test tools before using in production: 
cd mcp-stagehand-example.com
npx @modelcontextprotocol/inspector node dist/index.js

​
4. Combine Multiple Servers

Use multiple MCP servers together for powerful workflows:
  • Research: HN + Reddit + Substack
  • Development: GitHub + Stack Overflow + Dev.to
  • Content: Medium + Substack + Hashnode

​
Tips for Success

Pro Tips

Learn from successful MCPKit users:
  1. Be specific with URLs - Use the exact page where actions happen 
    # Instead of homepage
mcpkit create https://mcpkit.sh/team/issues
  2. Complete authentication fully - Including 2FA before continuing
  3. Test in Inspector first - Validate tools before production use
  4. Handle rate limits - Add delays between rapid requests
  5. Keep contexts fresh - Refresh authentication periodically

​
Need Help?

Each example includes troubleshooting tips. If you run into issues:

Join Discord

Ask the community for help

GitHub Discussions

Share your examples and get feedback

​
Next Steps

Hacker News Example

Build a Hacker News MCP

Substack Example

Build a Substack MCP

Custom Tools

Learn to customize generated servers

Authentication

Deep dive into auth handling