AI-agenter (MCP)

Toolsets og verktøy

Hvordan AmICited MCP-serveren eksponerer over 300 verktøy uten å oversvømme agentens kontekst: et lite annonsert sett, fire metaverktøy for å finne og kjøre resten, og tolv toolsets.

Åpne i ChatGPT Åpne i Claude

AmICited MCP-serveren registrerer over 300 verktøy, ett for alt dashbordet kan gjøre. Å gi en modell alle disse definisjonene ved hver forespørsel ville brukt en stor del av konteksten før den gjorde noe arbeid, og modeller velger verktøy dårligere fra en veldig lang liste. Derfor avslører serveren dem gradvis: klienten din ser en kort liste, og agenten slår opp resten når den trenger dem.

Du trenger ikke administrere noe av dette. Agenter følger mønsteret på egen hånd, veiledet av serverens instruksjoner og using-amicited-skillen. Denne siden forklarer hva de gjør, slik at du kan lese en transkripsjon, eller begrense flaten med vilje.

Hva klienten din ser#

tools/list annonserer et lite, fast sett:

Verktøy	Hva det er til for
`list_domains`	Domenene i arbeidsområdet, med id-ene alle andre verktøy trenger
`list_prompts`	Sporede prompts for et domene
`list_competitors`	Sporede konkurrenter for et domene
`list_tags`	Prompttagger for et domene
`prompt_analytics`	Hovedtallene for AI-synlighet
`report_link`	En fungerende lenke til en hvilken som helst rapport eller innstillingsside i appen
`list_toolsets`	De tolv produktområdene, én linje hver, med antall verktøy
`search_tools`	Finn et verktøy etter hva du vil gjøre
`describe_tool`	Les ett verktøys fullstendige inputskjema
`read_tool`	Kjør et skrivebeskyttet verktøy ved navn
`run_tool`	Kjør et hvilket som helst verktøy ved navn, inkludert skriving og verktøy som bruker kreditter

Fordi denne listen aldri endrer seg under en samtale, forblir klientens promptbuffer gyldig, noe som holder lange økter raske og billige.

Finn, inspiser, kjør#

Hvert annet verktøy nås i tre trinn:

text

search_tools  {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool     {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}

search_tools rangerer verktøy etter navn, beskrivelse og toolset. Det fungerer best med spørsmålet i vanlige ord («is the site down», «customer lifetime value») heller enn et halvt husket navn. Send toolset med en tom spørring for å bla i ett område, og øk offset for å bla gjennom et stort.
describe_tool returnerer det faktiske argumentskjemaet og verktøyets type. Agenter bør alltid kalle det før de kjører et verktøy, fordi noen verktøy tar flate argumenter og andre et nøstet query-objekt.
read_tool kjører verktøy av typen read: gratis, gjentakbare lesninger av dine egne data. Det avviser alt annet, og derfor er det merket som skrivebeskyttet og derfor kan forsiktige klienter (for eksempel Codex med godkjenninger slått av) bruke det uten å stoppe for å spørre.
run_tool kjører alt, inkludert de tre andre typene:

Type	Betydning
`read`	Leser arbeidsområdets data. Gratis.
`external`	Kaller et tredjeparts-API (Google, Bing, Meta, OpenAI, dataleverandører) eller koster kreditter
`write`	Oppretter eller redigerer arbeidsområdets data. Krever scopet `amicited:write`
`destructive`	Sletter data, eller starter og stopper reelt annonseforbruk

Et verktøy som ikke er annonsert, er ikke mindre beskyttet. Hvert verktøy sjekker tillatelser, plangrenser og kreditter selv, og run_tool bruker målverktøyets egen skrivesjekk, så et skrivebeskyttet token kan ikke nå en skriving gjennom det.

De tolv toolsettene#

Hvert verktøy tilhører nøyaktig ett toolset. Agenter bruker dem til å avgjøre hvor de skal søke, og du kan bruke dem til å feste et område (se nedenfor).

Toolset	Hva det dekker	Eksempelverktøy
`domains`	Domener, konkurrenter og tagger: id-ene alle andre toolsets tar	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Sporede prompts og svarene deres: opprett, planlegg, les svar, fan-outs, dekning	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Hvor domenet vises i AI-svar: måltall over tid, siterte kilder, Share of Voice, semantiske kart	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console og Bing Webmaster Tools: spørringer, sider, indeksdekning, sitemaps, URL-innsending	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Rapportering fra Google Ads, Microsoft Ads, Meta og LinkedIn: forbruk, kampanjer, nøkkelord, søkeord, ekte ROAS	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: les resultater, og opprett eller rediger kampanjer, annonsegrupper, kreativer og konverteringssporing	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Datavarehusbygget organisk analyse: movers, striking distance, CTR- og siteringsgap, kannibalisering, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Nettbutikkanalyse: omsetning og margin, produkter, kunder, kohorter og LTV, segmenter, kostnadsinput	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitorer, heartbeats, hendelser, SLA-rapporter, vedlikeholdsvinduer, statussider	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	AI-artikler, annotasjoner og regler for intern lenking for en tilkoblet butikk	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Nettstedshelse for AI-agenter: agenttilgjengelighet, llms.txt-gjennomgang, Web Vitals, ferskhet, nettstedsrevisjon, tilbakekoblinger	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Tilkoblede dataplattformer, synkroniseringsstatus, importer og varselinnboksen	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Verktøynavn har prefiks etter område (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), noe som gjør transkripsjoner enkle å skanne.

Feste toolsets med `?toolsets=`#

Noen klienter håndterer et nøstet run_tool-kall dårlig, og noen ganger vil du ha en smal agent som bare ser ett område. Legg til en spørringsparameter i tilkoblings-URL-en:

text

https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all

De navngitte toolsettene annonseres da direkte i tools/list, ved siden av kjernesettet. all annonserer alt, som gir slipp på kontekstbesparelsen, så bruk det bare med klienter som gjør sitt eget verktøysøk. Ukjente navn ignoreres i stedet for å avvises, så sjekk stavemåten hvis et område ikke vises. Utvalget er fast så lenge tilkoblingen varer; ingen verktøy kan utvide det midt i en samtale.

Sider, felter og grenser#

Sider på 25 rader. Hvert verktøy som returnerer en liste med rader, returnerer 25 som standard, opptil maksimalt 500 per kall. Når det finnes flere rader, inneholder svaret en paging-blokk med has_more og verdien som skal sendes i neste kall (en native offset eller side, eller en next_cursor).
fields. Verktøy som returnerer én liste med rader, godtar en fields-array for å returnere bare kolonnene du trenger. En kolonne radene ikke har, avvises, ikke ignoreres.
Ikke noe arbeidsområdeargument. Arbeidsområdet er fastsatt av legitimasjonen din, så ingen verktøy godtar en arbeidsområde-id. Nesten hvert verktøy trenger en domain_id fra list_domains.
Timesgrense. Verktøykall telles per arbeidsområde per time (se koble til). Å liste verktøy og lese skills er gratis; et skjult verktøy nådd gjennom read_tool eller run_tool teller én gang.

Relatert#

Playbook-skills Hvilke verktøy som skal kalles, i hvilken rekkefølge, for reelle spørsmål. Oppskrifter Prompts som setter disse verktøyene i arbeid.