Tool Reference
Complete API documentation for all 4 Agentcy tools. Parameters, example queries, and response formats.
agentcy
Analyze marketing data across all connected sources — analytics, search, ads, competitors, content, e-commerce. The server automatically routes to the right data sources, or use source_hints to suggest.
| Parameter | Type | Description |
|---|---|---|
request | string | Natural language question.Required |
domain | string | Domain to query (e.g., "example.com"). Optional — if omitted, the server uses your default domain. Always ask the user which domain if not obvious from context. |
start_date | string | Start date: YYYY-MM-DD or relative (e.g., '30daysAgo').Default: 30 days ago |
end_date | string | End date: YYYY-MM-DD or relative (e.g., 'today', 'yesterday').Default: yesterday |
source_hints | string[] | Preferred data sources. If omitted, server auto-selects via semantic routing. |
reference_images | string[] | URLs of reference images (max 5) for image generation — logos, product photos, brand colors, style references. Use to maintain brand consistency across generated visuals. |
Query
Use the agentcy tool:
request: "How is organic traffic trending this month?"
domain: "aurora-fitness.com"
start_date: "30daysAgo"Response
Organic Traffic Analysis — aurora-fitness.com
Last 30 Days vs Previous Period
• Sessions: 12,847 (+18.3%)
• Top landing page: /protein-powder-guide (2,104 sessions)
• Avg position improved: 14.2 → 11.8
• New keywords ranking: 47 new terms in top 20
• Conversion rate: 3.2% (up from 2.8%)
Recommendation: Your protein powder guide is driving
significant growth. Consider expanding the content
cluster with related long-tail topics.
Sources: GA4, Google Search Consoleresearch
Research any topic — search 100+ engines, read webpages, extract YouTube transcripts. Works without a domain. Use for general research, competitor analysis, or content extraction.
| Parameter | Type | Description |
|---|---|---|
request | string | Natural language research question.Required |
domain | string | Optional domain for context (e.g., "example.com"). Helps focus competitor research. |
Query
Use the research tool:
request: "What pricing strategies are competitors
using for protein supplements?"
domain: "aurora-fitness.com"Response
Competitor Pricing Analysis — Protein Supplements
Top 5 competitors analyzed:
1. GNC — Premium tier ($45-60/lb), loyalty discounts
2. Optimum Nutrition — Mid-range ($30-40/lb), bundle deals
3. MyProtein — Value ($20-30/lb), aggressive sales
4. Transparent Labs — Premium ($50+/lb), quality focus
5. Ghost — Lifestyle ($35-45/lb), brand partnerships
Key patterns:
• Subscribe-and-save (15-25% off) is universal
• Bundle pricing drives 30%+ higher AOV
• Free shipping thresholds: $49-75 range
Sources: 12 web pages, 3 YouTube reviewslist_sources
List available data sources and configured domains. Call this to discover which services and domains are available before querying. If exactly one domain exists, use it automatically without asking.
| Parameter | Type | Description |
|---|---|---|
domain | string | Domain to filter by. If omitted, lists all configured domains and global services. |
Query
Use the list_sources tool
(no parameters required)Response
Configured domains:
- aurora-fitness.com: ga4, gsc, google_ads, woocommerce
- northpeak-outdoor.com: ga4, gsc, spyfu
Global services (available for all domains):
- web_intelligence (Research)
- nano_banana (Image Generation)
- pagespeed (PageSpeed)
- dns_lookup (DNS Lookup)
Service IDs can be used as source_hints.get_current_date
Get the current date, day of week, and timezone. Useful for constructing date ranges in queries.
No parameters required.
Query
Use the get_current_date tool
(no parameters required)Response
Date: 2026-03-09
Day: Monday
TZ: UTC (UTC, UTC+0)