How to integrate Crawleo MCP server in Goose IDE
Goose is Block's open-source AI agent, and with the Crawleo MCP server it gains live web search and crawling. This tutorial shows exactly where to add Crawleo as an MCP extension in Goose, how to pass your API key, and how to confirm the tools are available to your agent. In a few minutes Goose can answer with current web data instead of guessing.
What you'll learn
- Adding Crawleo as an MCP extension in Goose
- Configuring the command and API key
- Confirming the search and crawl tools load
- Running a live query from Goose
Step-by-step guide
- 1
Copy your Crawleo API key
From the Crawleo Dashboard, copy your API key. You'll provide it to Goose so the MCP server can authenticate.
- 2
Open Goose settings and add an extension
In Goose, open Settings → Extensions and choose to add a new MCP extension. This is where you register the Crawleo server.
- 3
Configure the Crawleo MCP server
Enter the Crawleo MCP command (or remote endpoint) and add your API key as the required environment value, exactly as shown in the Crawleo MCP docs.
- 4
Enable the extension
Toggle the extension on. Goose will start the server and load Crawleo's tools — search, crawl, and more — into the agent's toolset.
- 5
Ask Goose a live question
Prompt Goose with something that needs fresh data. It calls the Crawleo tool, fetches results, and answers with up-to-date, sourced information.
Frequently asked questions
Why use MCP instead of a plugin?
MCP (Model Context Protocol) is a standard interface, so the same Crawleo server works across Goose, Cursor, Claude, and other clients — set it up once, reuse everywhere.
Do I need a paid Crawleo plan to follow this tutorial?
No. Crawleo has a free tier that includes credits for search and crawling, so you can complete the entire setup and run real requests without entering a card. Create an account at crawleo.dev, grab your API key, and you're ready.
Where do I get my Crawleo API key?
Sign in at crawleo.dev, open your Dashboard, and copy the API key from the API Keys section. Treat it like a password and store it in an environment variable rather than committing it to source control.
Try it with your own API key
Create a free Crawleo account and follow along — no card required.
