Introduction
Quickstart Guide
Get started with WebLinq in under 5 minutes - choose between MCP integration or direct API access
The Model Context Protocol (MCP) provides seamless integration with AI applications like Claude Desktop, Cursor, and VS Code. This is the easiest way to use WebLinq tools.
1
Get your API key
- Sign up for WebLinq - it’s free to start
- Go to API Keys tab in your dashboard
- Generate a new API key.
Copy your API key immediately - you won’t see it again after generation.
2
Configure your MCP client
WebLinq works with any MCP-compatible application. Choose your preferred client and add the configuration:
Claude Desktop
Claude Desktop
Edit your
claude_desktop_config.json file:Cursor / VS Code
Cursor / VS Code
Add to your MCP settings in
.cursor/mcp.json:LM Studio
LM Studio
Configure in LM Studio’s MCP settings (Perfect for: Research with local models, extracting documentation, analyzing websites.
mcp.json):BoltAI (macOS)
BoltAI (macOS)
Import configuration or manually add to BoltAI settings:Perfect for: Quick web research, screenshot capture, content extraction across apps.
TypingMind
TypingMind
Enable WebLinq as a plugin in TypingMind settings:Perfect for: Content creation, market research, competitive analysis.
MCPOmni-Connect (CLI)
MCPOmni-Connect (CLI)
Connect via command line interface for automation:Perfect for: Automation scripts, batch processing, command-line workflows.
Postman (Testing)
Postman (Testing)
Test WebLinq MCP tools directly in Postman for debugging:Perfect for: API testing, debugging tool calls, validating responses.
Replace
your_api_key_here with your actual API key from the dashboard.3
Start using WebLinq tools
Start using WebLinq tools naturally in conversation with your MCP client:Available tools:
- screenshot - Capture high-quality webpage screenshots
- extract_markdown - Convert any webpage to clean markdown
- ai_extract - Extract structured data using AI (pricing tables, features, etc.)
- web_search - Search the internet for real-time information
- scrape_elements - Extract specific elements using CSS selectors
- generate_pdf - Create PDF documents from web pages
- extract_links - Get all internal and external links
- extract_youtube_captions - Get video transcripts and subtitles
MCP Troubleshooting
Authentication Issues
Authentication Issues
Common authentication problems and solutions:
- Ensure the
--headerargument includesAuthorization:Bearer your_api_key_here - Replace
your_api_key_herewith your actual API key - Check your configuration file syntax is valid JSON
- Restart your MCP client after configuration changes
Transport Details
Transport Details
WebLinq uses the modern Streamable HTTP Transport: - Endpoint:
https://mcp.weblinq.dev/mcp - Protocol: MCP version 2025-03-26 -
Bridge Tool: mcp-remote handles the connection - Legacy Support:
/sse endpoint available for compatibilityCommon Issues
Common Issues
Troubleshooting tips:Tools not appearing: Check your config file syntax and restart your MCP clientAPI key errors: Test with
curl -H "Authorization: Bearer YOUR_KEY" https://api.weblinq.dev/v1/web/markdownConnection timeouts: Check internet connection and firewall settingsGeneral Tips
Rate limits
Rate limits
Check these headers in API responses:
X-RateLimit-Remaining: Requests left in current windowX-RateLimit-Reset: When the limit resets
Error handling
Error handling
Always check the
success field in responses:Security
Security
- Store API keys in environment variables
- Never commit keys to version control
- Use different keys for development and production
- Rotate keys regularly
What’s Next?
Explore All Tools
Browse complete API reference with all available endpoints
Learn MCP Protocol
Deep dive into Model Context Protocol fundamentals
Security Guide
Best practices for secure WebLinq integration
Use Case Examples
Real-world examples and implementation patterns