Docs · AI agents
Remote MCP server
Gridlode runs a remote Model Context Protocol server. Every engine is a tool your AI assistant can call, using the same API key and credits as the REST API. Failed calls are free.
| Endpoint | https://api.gridlode.com/mcp |
|---|---|
| Transport | Streamable HTTP (JSON responses) |
| Auth | Authorization: Bearer sk_live_… |
| Tools | 115 (one per engine plus get_account_balance) |
Claude Code
Terminal
claude mcp add --transport http gridlode https://api.gridlode.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Claude Desktop, Cursor and other clients
mcp.json
{
"mcpServers": {
"gridlode": {
"type": "http",
"url": "https://api.gridlode.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Test with curl
tools/list
curl https://api.gridlode.com/mcp \
-H "Authorization: Bearer $GRIDLODE_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Tool names
Tool names are the engine slugs with dots replaced by underscores:
ai_extract· AI Data Extraction (Usage-based)ai_review_insights· AI Review Insights (Usage-based)apps_app_store_app· App Store App Details (1 credit / request)apps_app_store_search· App Store Search (1 credit / request)apps_google_play_app· Google Play App Details (2 credits / request)apps_google_play_search· Google Play Search (2 credits / request)classifieds_autoscout24· AutoScout24 Car Listings (2 credits / listing)classifieds_craigslist· Craigslist Listings Search (1 credit / listing)classifieds_mobile_de· mobile.de Car Listings (2 credits / listing)classifieds_olx· OLX Listings Search (1 credit / listing)code_github_repo· GitHub Repository (1 credit / request)code_github_search· GitHub Repository Search (1 credit / request)code_github_trending· GitHub Trending (1 credit / request)code_github_user· GitHub User & Organization (1 credit / request)contacts_company_website· Company Website Finder (2 credits / request)contacts_email_check· Email Checker (1 credit / request)contacts_email_finder· Email Finder (5 credits / request)contacts_phone· Phone Validator (1 credit / request)contacts_website· Emails & Contacts from Website (2 credits / request)domain_authority· Domain Authority (1 credit / request)domain_availability· Domain Availability (1 credit / request)domain_backlinks· Referring Domains (Backlinks) (0.05 credits / domain)domain_dns· DNS Lookup (1 credit / request)domain_email_security· Email Security Audit (1 credit / request)domain_ip_info· IP Lookup (ASN, Network, Hosting) (1 credit / request)domain_rdap· RDAP Lookup (1 credit / request)domain_similar_sites· Similar Sites (3 credits / request)domain_ssl· SSL Certificate Check (1 credit / request)domain_subdomains· Subdomain Finder (2 credits / request)domain_tech· Technology Lookup (2 credits / request)domain_whois· WHOIS Lookup (1 credit / request)ecommerce_amazon_product· Amazon Product (3 credits / request)ecommerce_amazon_search· Amazon Search Results (3 credits / request)ecommerce_ebay_item· eBay Item Details (2 credits / request)ecommerce_ebay_search· eBay Search Results (2 credits / request)ecommerce_shopify_store· Shopify Store Products (0.02 credits / product)ecommerce_walmart_product· Walmart Product (2 credits / request)ecommerce_walmart_search· Walmart Search Results (2 credits / request)jobs_ashby· Ashby Job Board (1 credit / request)jobs_company_site· Company Careers Page Jobs (1 credit / request)jobs_greenhouse· Greenhouse Job Board (1 credit / request)jobs_lever· Lever Job Board (1 credit / request)places_angi· Angi Pro Search (2 credits / business)places_bbb· BBB Business Search & Profiles (2 credits / business)places_bing_maps· Bing Maps Places Search (1 credit / business)places_google_maps· Google Maps Places Search (2 credits / place)places_google_maps_photos· Google Maps Place Photos (1 credit / request)places_google_maps_place· Google Maps Place Details (2 credits / request)places_google_maps_rank· Google Maps Rank Grid (2 credits / point)places_yellowpages· Yellow Pages Business Search (2 credits / business)realestate_redfin· Redfin Property Details (5 credits / property)realestate_zillow_property· Zillow Property Details (5 credits / property)realestate_zillow_search· Zillow Listings Search (3 credits / listing)reviews_app_store· App Store Reviews (1 credit / review)reviews_booking· Booking.com Hotel Reviews (2 credits / review)reviews_google_maps· Google Maps Reviews (0.5 credits / review)reviews_google_play· Google Play Reviews (1 credit / review)reviews_tripadvisor· Tripadvisor Reviews & Business Info (2 credits / review)reviews_trustpilot· Trustpilot Reviews (1 credit / review)serp_baidu· Baidu Search (1 credit / request)serp_bing· Bing Search (1 credit / request)serp_bing_images· Bing Images Search (1 credit / request)serp_bing_news· Bing News Search (1 credit / request)serp_bing_videos· Bing Videos Search (1 credit / request)serp_brave· Brave Search (1 credit / request)serp_cse· Custom Search API Replacement (2 credits / request)serp_duckduckgo· DuckDuckGo Search (1 credit / request)serp_google· Google Search (3 credits / page)serp_google_ai_mode· Google AI Mode (6 credits / request)serp_google_autocomplete· Google Autocomplete (1 credit / request)serp_google_books· Google Books (1 credit / request)serp_google_finance· Google Finance (2 credits / request)serp_google_images· Google Images Search (3 credits / request)serp_google_news· Google News (1 credit / request)serp_google_patent· Google Patent Details (1 credit / request)serp_google_patents· Google Patents Search (1 credit / request)serp_google_scholar· Google Scholar (2 credits / request)serp_google_trends· Google Trends (2 credits / request)serp_google_trends_trending· Google Trends Trending Now (1 credit / request)serp_naver· Naver Search (1 credit / request)serp_yahoo· Yahoo Search (1 credit / request)serp_yandex· Yandex Search (1 credit / request)social_facebook_page· Facebook Page (2 credits / request)social_google_ads· Google Ads Transparency Center (2 credits / page)social_instagram_profile· Instagram Profile (2 credits / request)social_meta_ads· Meta Ad Library (2 credits / page)social_pinterest_profile· Pinterest Profile & Board (2 credits / request)social_tiktok_ads· TikTok Ad Library (2 credits / page)social_tiktok_profile· TikTok Profile (2 credits / request)social_tiktok_video· TikTok Video (1 credit / request)travel_airbnb_listing· Airbnb Listing Details & Reviews (3 credits / listing)travel_airbnb_search· Airbnb Stays Search (2 credits / listing)travel_google_flights· Google Flights Search (2 credits / request)travel_google_hotels· Google Hotels Search (2 credits / request)url_broken_links· Broken Link Checker (1 credit / page)url_crawl· Website Crawler (Markdown for RAG) (1 credit / page)url_geo_audit· GEO / AI-Readiness Audit (2 credits / request)url_headers· HTTP Headers & Security Check (1 credit / request)url_html· Page HTML (1 credit / request)url_keyword_density· Keyword Density (1 credit / request)url_links· Page Links Extractor (1 credit / request)url_markdown· URL to Markdown (1 credit / request)url_metadata· Page Metadata & SEO Tags (1 credit / request)url_pagespeed· PageSpeed & Core Web Vitals Test (3 credits / request)url_readability· Article Extractor & Readability (1 credit / request)url_screenshot· Screenshot (2 credits / request)url_sitemap· Sitemap Parser (2 credits / request)video_youtube_channel· YouTube Channel (1 credit / request)video_youtube_comments· YouTube Comments (0.05 credits / comment)video_youtube_search· YouTube Search (1 credit / page)video_youtube_transcript· YouTube Transcript (1 credit / request)video_youtube_video· YouTube Video Details (1 credit / request)domain_reverse_ids· Reverse Analytics & AdSense ID Lookup (3 credits / request)contacts_company_profile· Company Enrichment (6 credits / request)
Tool results include the engine's data as text and as structuredContent with the credits charged.