Hacker News Example

mcpkit create https://news.ycombinator.com

User: Show me the top article on Hacker News
AI: [Uses view_article with the title of the top article]

User: Show me the comments on the article about AI safety
AI: [Uses view_comments with title "AI safety discussion"]

User: What are the newest posts on HN?
AI: [Uses navigate_section with section "new"]

User: Search Hacker News for articles about React
AI: [Uses search_posts with query "React"]

User: Show me pg's profile on Hacker News
AI: [Uses view_user_profile with username "pg"]

cd mcp-stagehand-news.ycombinator.com
npm install
npm run build

npx @modelcontextprotocol/inspector node dist/index.js

claude mcp add --transport stdio "hackernews" -- node /absolute/path/to/dist/index.js

// Example: view_article tool implementation
async function viewArticle(title: string) {
  const stagehand = await initStagehand();
  const page = stagehand.context.pages()[0];

  await page.goto(TARGET_URL);

  // Use Stagehand's act method to click the article
  await stagehand.act(`click on the article titled "${title}"`);

  // Extract article content
  const content = await stagehand.extract(
    "extract article title, URL, and text content",
    z.object({
      title: z.string(),
      url: z.string().url(),
      content: z.string()
    })
  );

  return content;
}

// Add a tool to get top comments
{
  name: "get_top_comments",
  description: "Get the most upvoted comments on an article",
  inputSchema: {
    type: "object",
    properties: {
      title: { type: "string" },
      limit: { type: "number", default: 5 }
    }
  }
}

const ArticleSchema = z.object({
  title: z.string(),
  url: z.string().url(),
  points: z.number(),
  author: z.string(),
  timestamp: z.string(),
  commentCount: z.number(),
  content: z.string().optional()
});

const articleCache = new Map();

async function viewArticle(title: string) {
  if (articleCache.has(title)) {
    return articleCache.get(title);
  }

  const result = await fetchArticle(title);
  articleCache.set(title, result);
  return result;
}