Quickstart
This guide gets you from zero to your first result. You will create an API key, make one request with cURL, JavaScript or Python, and then connect Claude Code so it can call the same tools on its own.
You need a Pengu Insights account on the Pro plan or above. Pro includes the API and the MCP server along with 1,200 credits a month; Agency, 3,000. Keys are created in the app under Settings » Developers.
Create an API key
Open Settings » Developers, give the key a name such as "Claude Code" or "n8n", and press Create key. The full key is shown once. Copy it somewhere safe: it starts with pk_live_ and it is the only credential you need.
Keep it out of browsers and out of git. If a key leaks, revoke it from the same screen and create another. You can have up to ten active keys per account, and each one draws from the same credit balance.
Make your first request
Every tool is a POST with a JSON body. The base URL is https://suvjexogmfpvxjcktvuk.supabase.co/functions/v1/api/v1, and the key goes in the Authorization header. Here is a keyword research call.
curl -X POST https://suvjexogmfpvxjcktvuk.supabase.co/functions/v1/api/v1/keywords/ideas \
-H "Authorization: Bearer $PENGU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "running shoes", "country": "US", "limit": 20}'
The response has two top level keys: data, which is the result, and meta, which tells you how many credits the call cost and how many you have left.
Response
{
"data": {
"seed": { "keyword": "running shoes", "volume": 301000, "cpc": 1.17, "difficulty": 43, "intent": "transactional" },
"country": "US",
"language": "en",
"count": 20,
"keywords": [
{ "keyword": "sneaker running shoes", "volume": 301000, "cpc": 1.17, "competition": "high", "difficulty": 7, "intent": "transactional" }
// ...
]
},
"meta": { "credits_charged": 2.5, "credits_remaining": 497.5, "request_id": "e701ba5b-..." }
}
Connect Claude Code
The same key works with the MCP server, which exposes every endpoint as a tool an AI agent can call. In Claude Code, run:
Claude Code
claude mcp add --transport http pengu \
https://suvjexogmfpvxjcktvuk.supabase.co/functions/v1/mcp \
--header "Authorization: Bearer pk_live_YOUR_KEY"
Then ask something like "What does hubspot.com rank for in Spain, and who are its main competitors?". Claude picks the tools, makes the calls, and the credits come off your account exactly as they would through the REST API.