arguseek-client
v0.4.3
Published
ArguSeek MCP client for Claude Desktop - bridges stdio to HTTP
Readme
ArguSeek
ArguSeek transforms your AI coding agent from a simple assistant into a research powerhouse. It provides two specialized tools through the Model Context Protocol (MCP):
- Deep Research: Performs multi-query, parallel web research with intelligent synthesis
- Targeted Content Extraction: Fetches and analyzes specific web pages with context-aware extraction
Instead of basic web searches, ArguSeek finds exactly what you need through comprehensive, iterative research.
Key Benefits
Finds What Others Can't
- Uncovers solutions in obscure GitHub issues, forgotten blog posts, and buried documentation
- Automatically searches multiple variations of your query to catch edge cases
- Connects related information across sources for comprehensive answers
Saves Hours of Research
- One query spawns multiple parallel searches across the entire web
- Intelligent filtering focuses on truly relevant, high-quality sources
- Built-in caching means you never search the same thing twice
Perfect for Real Coding Challenges
- Debug cryptic errors by finding others who solved them
- Discover undocumented API features and workarounds
- Compare tools, services, and pricing across vendors
- Learn best practices that actually work in production
- Extract specific information from documentation and API guides
Progressive Deep Dives
- Start broad, then drill down into specifics
- Each search builds on previous findings
- Maintains context across your entire research session
Quick Start
Production
ARGUSEEK_API_KEY=your-api-key npx arguseek-clientDevelopment Environment
# Use the test key for development
ARGUSEEK_API_KEY=test-key ARGUSEEK_URL=https://arguseek-dev-spektc56ga-uc.a.run.app/mcp npx arguseek-clientGet an API Key
Production: Visit arguseek.com to get your API key.
Development: Use the test key test-key with the dev environment.
Environments
Production
- URL:
https://arguseek-prod-4psitcfpnq-uc.a.run.app/mcp - Requires valid API key from arguseek.com
- Full rate limits and production SLAs
Development
- URL:
https://arguseek-dev-spektc56ga-uc.a.run.app/mcp - Test API key:
test-key - Limited to 500 requests/day
- May have slower response times
Configuration
Environment Variables
ARGUSEEK_API_KEY: Your API key (required)ARGUSEEK_URL: API endpoint (optional, defaults to production)
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"arguseek": {
"command": "npx",
"args": ["arguseek-client"],
"env": {
"ARGUSEEK_API_KEY": "your-api-key",
"ARGUSEEK_URL": "https://arguseek-prod-4psitcfpnq-uc.a.run.app/mcp"
}
}
}
}For development, use:
{
"mcpServers": {
"arguseek-dev": {
"command": "npx",
"args": ["arguseek-client"],
"env": {
"ARGUSEEK_API_KEY": "test-key",
"ARGUSEEK_URL": "https://arguseek-dev-spektc56ga-uc.a.run.app/mcp"
}
}
}
}Effective Agent Instructions
Maximize ArguSeek's power by giving your AI agent clear, specific research instructions:
For Implementation Tasks
- "Research $FEATURE best practices and common pitfalls before implementing. Look for production-ready examples."
- "Use ArguSeek to find how others solved $PROBLEM. Focus on recent implementations."
For Debugging
- "Research $ERROR_MESSAGE thoroughly. Find GitHub issues, forum discussions, and workarounds."
- "Search for others who encountered $ISSUE. Look for root causes and verified fixes."
For Architecture Decisions
- "Research pros, cons, and real-world experiences with $OPTIONS. Find performance comparisons and migration stories."
- "Use ArguSeek to validate $ASSUMPTION and discover potential gotchas before we commit to this approach."
For Learning New Tools
- "Research $TOOL beyond the official docs. Find tutorials, common mistakes, and undocumented features."
- "Search for $TECHNOLOGY production examples and battle-tested patterns. Focus on scale and edge cases."
- "Use fetch_url to extract specific API documentation from $URL. Focus on authentication and error handling."
For Complex Problems
- "Start with broad research on $TOPIC, then drill deeper into promising solutions. Follow interesting leads."
- "Research iteratively: first understand $PROBLEM_SPACE, then explore specific solutions, finally validate the approach."
Combining Both Tools
- "First research_iteratively to find the best $LIBRARY options, then fetch_url from their documentation to extract installation and configuration steps."
- "Use research to understand the problem space, then fetch_url to get specific implementation details from the most promising sources."
Tool-Specific Usage Examples
research_iteratively:
"Research React Server Components best practices and common pitfalls"
"Find solutions to 'CUDA out of memory' errors in PyTorch training"
"Compare Prisma vs Drizzle ORM for TypeScript projects in 2024"fetch_url:
"Extract pricing information and feature comparison from https://docs.stripe.com"
"Get installation steps and requirements from the FastAPI documentation"
"Parse API endpoints and authentication methods from this REST API guide"With ArguSeek, your AI agent doesn't just search—it investigates, analyzes, and delivers actionable intelligence. It's the difference between asking "what's the error?" and getting "here's exactly how three developers fixed this issue last month."
Development
For local development and testing, see DEVELOPMENT.md.
