Documentazione
Server MCP
Dai al tuo assistente o agente AI dati live da Amazon, Zalando, Otto, Zillow, Yahoo Finance, YouTube e altri. Punta un qualsiasi client MCP al nostro server ospitato, aggiungi la tua chiave API e il modello potrà cercare informazioni nel momento in cui qualcuno lo chiede.
Cosa ottieni
Un solo URL
Ospitato su
https://api.everydata.io/mcp. Niente da installare o eseguire in proprio.Tool tipizzati
31 tool con parametri chiari – amazon_product, zillow_search, youtube_comments – più un tool generico per ogni altro endpoint.
Stessa chiave, stessa quota
Le chiamate ai tool sono normali richieste API: stessi prezzi, stessi pesi, e le chiamate fallite vengono rimborsate.
Collegare un client
Il server parla MCP su Streamable HTTP. Accedi con OAuth (ChatGPT, Claude.ai) oppure autenticati con la tua chiave API come Authorization: Bearer … (o con l'header x-api-key). Ottieni una chiave nella dashboard – va bene anche il piano gratuito.
Claude Code
Un solo comando nel terminale.
claude mcp add --transport http everydata "https://api.everydata.io/mcp" \
--header "Authorization: Bearer YOUR_API_KEY"Cursor
Aggiungi a ~/.cursor/mcp.json (o a .cursor/mcp.json in un progetto).
{
"mcpServers": {
"everydata": {
"url": "https://api.everydata.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}VS Code
Aggiungi a .vscode/mcp.json.
{
"servers": {
"everydata": {
"type": "http",
"url": "https://api.everydata.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Desktop
Claude Desktop si collega ai server remoti con una chiave tramite il bridge mcp-remote (richiede Node.js). Aggiungi a claude_desktop_config.json e riavvia l'app.
{
"mcpServers": {
"everydata": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.everydata.io/mcp",
"--header",
"Authorization:${EVERYDATA_AUTH}"
],
"env": {
"EVERYDATA_AUTH": "Bearer YOUR_API_KEY"
}
}
}
}ChatGPT e Claude.ai (accesso con OAuth)
Aggiungi un connettore personalizzato con l'URL https://api.everydata.io/mcp e senza chiave. L'app ti porta su everydata per accedere e ti chiede di consentire l'accesso. Creiamo quindi una chiave API chiamata OAuth: <app> per l'app – revoca quella chiave in Chiavi API per scollegarla. Apri l'e-mail di accesso nello stesso browser, altrimenti la richiesta va persa.
Uso da un'API
Sia l'API di OpenAI sia quella di Anthropic possono chiamare server MCP remoti per te, così il tuo agente riceve i tool senza codice aggiuntivo.
OpenAI Responses API
{
"model": "gpt-6-astra",
"input": "Is the LCGENS 20W charger on Amazon a good deal right now?",
"tools": [
{
"type": "mcp",
"server_label": "everydata",
"server_url": "https://api.everydata.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
},
"require_approval": "never"
}
]
}Anthropic Messages API (connettore MCP)
Invia l'header anthropic-beta: mcp-client-2025-11-20. Ogni server in mcp_servers richiede una voce mcp_toolset corrispondente in tools, altrimenti la richiesta viene rifiutata.
{
"model": "claude-opus-5",
"max_tokens": 4096,
"messages": [
{
"role": "user",
"content": "Which 3-bed homes in 78704 are listed under $700k?"
}
],
"mcp_servers": [
{
"type": "url",
"url": "https://api.everydata.io/mcp",
"name": "everydata",
"authorization_token": "YOUR_API_KEY"
}
],
"tools": [
{
"type": "mcp_toolset",
"mcp_server_name": "everydata"
}
]
}Tool
Parametri e descrizioni corrispondono alla API reference. Ogni descrizione di tool indica anche il suo peso sulla quota, così il modello vede quanto costa una chiamata.
| Piattaforma | Tool | Cosa restituisce |
|---|---|---|
| Amazon | amazon_product | Pagina prodotto tramite URL |
| amazon_product_by_asin | Prodotto tramite ASIN e marketplace | |
| amazon_search | Ricerca per parola chiave | |
| amazon_offers | Tutte le offerte dei venditori per un ASIN | |
| amazon_reviews | Recensioni dei clienti | |
| amazon_best_sellers | Classifica dei più venduti di una categoria | |
| amazon_deals | Offerte del giorno | |
| Walmart | walmart_product | Pagina prodotto |
| walmart_search | Ricerca per parola chiave | |
| Zalando · Otto · Kaufland · Lidl · Asos | zalando_product | Pagina articolo |
| zalando_search | Ricerca per parola chiave | |
| otto_product | Pagina prodotto | |
| otto_search | Ricerca per parola chiave | |
| kaufland_product | Pagina prodotto | |
| kaufland_search | Ricerca per parola chiave | |
| lidl_product | Pagina prodotto | |
| lidl_search | Ricerca per parola chiave | |
| asos_product | Pagina prodotto | |
| asos_search | Ricerca per parola chiave | |
| Zillow | zillow_property | Dettagli dell'immobile e Zestimate |
| zillow_search | Annunci per una località | |
| Yahoo Finance | yahoo_quotes | Quotazioni live per simboli |
| yahoo_chart | Storico prezzi | |
| yahoo_profile | Profilo aziendale | |
| YouTube | youtube_video | Dettagli e statistiche del video |
| youtube_search | Ricerca video | |
| youtube_comments | Commenti di un video | |
| youtube_channel | Dettagli del canale | |
| Tutto il resto | list_endpoints | Elenca tutti gli endpoint di dati con parametri e peso sulla quota |
| call_endpoint | Chiama un qualsiasi endpoint elencato tramite il percorso | |
| account_quota | La tua quota residua di questo mese |
Quota e limiti
- Ogni chiamata a un tool è una richiesta API sul tuo account e conta come qualsiasi altra richiesta – incluso il peso della piattaforma (le pagine prodotto di Zillow, Zalando e Otto contano 2 unità).
- Le chiamate fallite (il sito ci ha bloccato o non era raggiungibile) e quelle rifiutate vengono rimborsate automaticamente.
- Si applica il rate limit al minuto del tuo piano. Le risposte grandi vengono abbreviate per la context window del modello; il tool dice poi al modello di restringere la richiesta (ad esempio una pagina più piccola o meno recensioni).
- Elencare i tool è gratuito, ma richiede una chiave o un accesso OAuth.
account_quotamostra quanto resta questo mese.
Vedi Limiti e quota e prezzi per i valori di ogni piano.