documentation/docs/mcp/apify-mcp.md
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller';
This tutorial covers how to add the Apify MCP server as a goose extension, enabling goose to call thousands of tools from Apify Store to extract data from social media, e-commerce sites, search engines, online maps, or any other website.
:::tip Quick Install
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
Launch the installer
</TabItem>
<TabItem value="cli" label="goose CLI">
Add a Remote Extension (Streaming HTTP) extension type with:
Endpoint URL
https://mcp.apify.com
Custom Request Header
Authorization: Bearer <YOUR_APIFY_TOKEN>
:::
<Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> <GooseDesktopInstaller extensionId="apify" extensionName="Apify" description="Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store" type="http" url="https://mcp.apify.com" envVars={[ { name: "Authorization", label: "Bearer YOUR_APIFY_TOKEN" } ]} apiKeyLink="https://console.apify.com/settings/integrations" apiKeyLinkText="Apify Token" /> </TabItem> <TabItem value="cli" label="goose CLI"> <CLIExtensionInstructions name="Apify" description="Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store" type="http" url="https://mcp.apify.com" timeout={300} envVars={[ { key: "Authorization", value: "Bearer apify_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } ]} infoNote={ <> Obtain your <a href="https://console.apify.com/settings/integrations" target="_blank" rel="noopener noreferrer">Apify Token</a> and paste it in as the <code>Bearer</code> token. </> } /> </TabItem> </Tabs> </TabItem> <!-- LOCAL SETUP --> <TabItem value="local" label="Apify Local MCP">:::tip Quick Install <Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> Launch the installer </TabItem>
<TabItem value="cli" label="goose CLI"> **Command** ```sh npx -y @apify/actors-mcp-server ``` </TabItem> </Tabs>Environment Variables
APIFY_TOKEN: <YOUR_APIFY_TOKEN>
:::
<Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> <GooseDesktopInstaller extensionId="mcp_apify_local" extensionName="Apify Local MCP Server" description="Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store" type="stdio" command="npx" args={["-y", "@apify/actors-mcp-server"]} envVars={[ { name: "APIFY_TOKEN", label: "<YOUR_APIFY_TOKEN>" } ]} apiKeyLink="https://console.apify.com/settings/integrations" apiKeyLinkText="Apify Token" /> </TabItem> <TabItem value="cli" label="goose CLI"> <CLIExtensionInstructions name="Apify Local MCP Server" description="Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store" type="stdio" command="npx -y @apify/actors-mcp-server" timeout={300} envVars={[ { key: "APIFY_TOKEN", value: "apify_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } ]} infoNote={ <> Obtain your <a href="https://console.apify.com/settings/integrations" target="_blank" rel="noopener noreferrer">Apify Token</a> and paste it in. </> } /> </TabItem> </Tabs> </TabItem> </Tabs>The Apify MCP server lets you connect goose to Apify Store, a marketplace of thousands of ready-made tools (called Actors) for all kinds of web scraping, crawling, and data extraction use cases. Learn more about Apify Actors in the official documentation
In this example, goose will use the Google Places Scraper Actor to identify the most credible, top-rated Italian restaurant in Prague based on public ratings, reviews, and fine-dining recognition.
( O)> Find the top-rated Italian restaurant in Prague with verifiable credibility — use Apify MCP to find Google Maps review scraper Actor, focus on places with at least 200+ reviews, an average rating of 4.7 or higher on Google, TripAdvisor, or OpenTable, and any Michelin or fine-dining recognition. Include the restaurant’s name, rating, total review count, address, cuisine style, and a short summary of what makes it stand out (e.g., service, ambiance, or signature dishes). Return to me only 1 restaurant with the highest rating to review count ratio
Based on the gathered information, the top-rated Italian restaurant in Prague with verifiable credibility is:
### **Al Tagliere**
* **Rating:** 4.7/5
* **Total Reviews:** 457
* **Address:** [Al Tagliere on TripAdvisor](https://www.tripadvisor.com/Restaurant_Review-g274707-d6835155-Reviews-Al_Tagliere-Prague_Bohemia.html)
* **Cuisine Style:** Italian
* **Summary:** Al Tagliere is celebrated for its authentic Italian dishes that showcase regional flavors. The restaurant is known for its delightful ambiance, attentive service, and signature dishes such as homemade pasta and traditional desserts. Patrons frequently highlight the freshness of ingredients and the welcoming atmosphere, making it a preferred choice for both locals and tourists.
This restaurant has a strong reputation and meets your criteria for quality and credibility.