add_plan_activity
ChatGPTAdd an activity to the marketing plan calendar (Annual/Monthly view): a recurring, seasonal or one-time activity placed in one or more months, e.g. "Monthly newsletter", "Open-house campaign (June)", "SEO refresh". Optionally link it to a strategy-card task via task_ref so the status is derived from that task. Anonymous marketing activities only — no applicant PII.
add_strategy_card
ChatGPTCreates an agent's strategy card with strategy content and tasks, without a five-card limit. Progress, severity and pillar coverage roll up to its manager dashboard automatically.
add_strategy_tasks
ChatGPTAppend more to-do items to an existing strategy card (grow the to-do list). New tasks are appended after existing ones. Changes roll up to the manager automatically.
analyze_competitor_website
ChatGPTPerform a comprehensive competitor website analysis including site structure, page hierarchy, content themes, technology stack, SEO elements (meta tags, headings, internal linking), and social media presence. Optionally deep-crawl up to 10 pages for a fuller picture.
analyze_pagespeed
ChatGPTAnalyze website loading performance via Google PageSpeed Insights API. Returns Lighthouse performance score (0-100), Core Web Vitals from real users (LCP, INP, CLS, FCP, TTFB), failed performance audits with estimated time/size savings, and prioritized optimization recommendations. Supports mobile and desktop analysis.
analyze_schema
ChatGPTPerform a full Schema.org structured data audit on any webpage. Extracts all JSON-LD, Microdata, and RDFa markup, then evaluates rich snippet eligibility for Google (Article, Product, FAQ, LocalBusiness, etc.), identifies missing required fields, finds schema errors, and provides prioritized recommendations for improving search result appearance.
approve_draft
ChatGPTApproves a draft. For a linked social post, approval can schedule its requested time or queue immediate publication to the external channel. The submitting agent cannot approve its own draft on a client-approved dashboard.
ask_director
ChatGPTRequests an answer from the project's server-run marketing director using plan, owner facts, team memory and recent project data. Available on self-serve dashboards. Counts toward the owner's daily answer cap and deducts model and data-read credits.
audit_pagespeed_full
ChatGPTRun a comprehensive Google Lighthouse audit covering all four categories: Performance (speed, Core Web Vitals), Accessibility (WCAG compliance, screen reader support), SEO (meta tags, crawlability, mobile-friendliness), and Best Practices (HTTPS, console errors, image formats). Returns scores for each category plus detailed failing audits with descriptions.
cancel_draft
ChatGPTWithdraws a draft and cancels its linked social post before publication. Publishing or published social posts cannot be cancelled here.
cancel_scheduled_report
ChatGPTSwitch off one of this project's recurring reports (it stays listed and a person can switch it back on).
check_facebook_ads
ChatGPTCheck whether a brand, company, or website is actively advertising on Facebook or Instagram using the public Facebook Ad Library. Accepts a domain (e.g. example.com) or a brand/page name (e.g. "Acme Coffee"). Returns is_advertising (bool), total_found, sample_ads with creative snippets + delivery dates + spend ranges + platforms, and a search_url for manual verification in the public Ad Library UI. Works for any public advertiser in the specified country — no permission from the target needed. Default country EE, status ALL, limit 10.
check_pagespeed_quick
ChatGPTReturns mobile and desktop performance scores and Core Web Vitals (LCP, INP, CLS), plus an overall assessment. Results are cached for five minutes.
check_schema_quick
ChatGPTQuick lightweight check of which Schema.org types exist on a page. Returns a simple list of found schema types (e.g. Organization, Article, Product) and counts by format (JSON-LD vs Microdata).
check_skill_updates
ChatGPTCompares supplied installed skill versions with current platform and team versions. Returns outdated, retired and newly available canonical entries with version and download metadata. Without installed entries, returns current canonical team versions.
check_url_status
ChatGPTFetches up to 20 public URLs using a selected crawler user-agent. Returns redirect hops, final status and URL, robots headers and meta tags, canonical and hreflang links, title, content type and HTML size. Bot-specific rules based on verified source IP addresses are not detected.
close_strategy_card
ChatGPTCloses a strategy card and moves it to completed history while preserving tasks.
configure_connection
ChatGPTGive a connection the setting it needs: GA4 property_id, Search Console site_url, Business Profile location_id, Bing site_url, Google Ads customer_id, Meta Ads ad_account_id, Facebook page_id, Instagram ig_business_account_id, LinkedIn organization_urn, Merchant Center merchant_id. Takes only the service's own setting fields (an error lists them) and checks them like PUT …/connections/{service}/configure: once every required setting is there the connection is connected and its tools appear; otherwise the answer names what is still missing. Does not change credentials.
contribute_skill
ChatGPTAdds a versioned Markdown playbook to the project's shared team library. Returns its slug and version. Retired slugs and content containing credentials are rejected.
create_dashboard
ChatGPTCreates a password-protected marketing dashboard with display widgets, date filters and a client view. Generates a password and returns it once with the dashboard URL; this display dashboard has no password settings page. Creation sends no invitations and creates no tasks or agents. Integration widgets read connected data when viewed.
create_scheduled_report
ChatGPTSet up a recurring marketing report that SharksAPI runs on its own schedule and e-mails as a PDF. Times are Europe/Tallinn.
delegate_to_agents
ChatGPTTOP-DOWN delegation: the Turundusjuht (manager) pushes work to one or MORE teammate agents in a single call. Each assignment becomes a strategy card on that agent's own Command Center, stamped "Turundusjuhilt" (assigned_by=manager) so the agent knows it came from the boss — and it rolls back up to the manager's rollup automatically. Dependencies are informational discipline for the agents — the manager is the orchestrator.
delete_dashboard
ChatGPTPermanently delete a dashboard by its public token. This also deletes all widgets and cached data. Only agents from the owning project can delete.
delete_strategy_card
ChatGPTPermanently deletes a strategy card and its tasks. Completed tasks prevent deletion unless force is true; the server does not separately verify user intent.
delete_strategy_task
ChatGPTDeletes an open AI task from a strategy card. Completed tasks and tasks controlled by a person cannot be deleted. task_id takes precedence over the alternative one-based task_number.
diagnose_connections
ChatGPTRun Connection Doctor for this project. Classifies missing configuration, expired authorization, temporary provider failures, and healthy connections without exposing credentials.
disconnect_service
ChatGPTDisconnect an integrated service and remove its stored credentials. This is irreversible — the service will need to be reconnected with fresh credentials.
edit_draft
ChatGPTReplaces the draft body and synchronizes its linked social caption. A linked post returns to pending review. Publishing or published social posts cannot change through this operation.
fetch
ChatGPTFetch details for a SharksAPI.AI search result by id.
fill_brand_sections
ChatGPTFills unsaved brand-guide sections from supplied brand-book data and marks them for client review. Existing client-saved sections remain unchanged. Brand readiness changes only after the client saves the sections.
first_value_status
ChatGPTShow this project's activation milestones: approved agent, connected data source, first useful non-setup run, and public dashboard. Returns progress, time-to-first-value, the next action, and a suggested prompt without credentials or task results.
get_ad_creatives
ChatGPTLists dashboard Meta ad creatives with content, client approval status, requested changes, external ad IDs and synchronization state. Includes pending action metadata.
get_analytics_summary
ChatGPTGet a dashboard overview of all connected marketing platforms (GA4, Search Console, Facebook, LinkedIn, Twitter, Google Ads, Meta Ads) with their connection status, property IDs, and configuration.
get_brand_guide
ChatGPTReturns the project's brand guide: logos, colors, fonts, tone, photo style, restrictions, required text, examples and asset files. Includes brand readiness, missing sections, icon style and asset usage-rights/consent flags.
get_client_messages
ChatGPTReturns dashboard conversations and task threads with messages and attachments without changing read status. unread_only selects unread messages, or unanswered messages on client-approved dashboards. Attachment downloads require the dashboard session cookie.
get_client_requests
ChatGPTLists the department dashboard's client requests, including events and campaigns, dates, budgets and statuses. Requests requiring additional budget await growth-lead approval.
get_connection_status
ChatGPTCheck the current connection status and health of a specific integrated service. Returns service status, connection timestamp, and any metadata or configuration details.
get_credit_status
ChatGPTCheck current credit balance for this project. The monthly limit is only the recurring free allowance, not a hard usage cap. Purchased or admin-granted credits remain usable after the free allowance is exhausted. Returns total spendable credits and a status based on that total.
get_dashboard
ChatGPTFetch a dashboard's configuration by its public token. Returns the dashboard metadata, widget list, and public URL — but not the live data (data is fetched on view).
get_dashboard_access_link
ChatGPTReturns a short-lived signed URL for a password-protected dashboard in this project. Opening it establishes a 24-hour unlock session and redirects to the dashboard. A manager session also unlocks child dashboards. The link expires after ttl_minutes, default 15 and maximum 60; the dashboard password remains in place.
get_department_plan
ChatGPTReturns the department's current marketing plan, KPIs and monthly history, pillars, calendar, milestones, budget, initiatives, rules, risks, decisions, version history and pending plan documents.
get_department_plan_document
ChatGPTReturns the extracted text of a plan document uploaded to the department dashboard. Supports PDF, Word, text and Markdown files.
get_ga4
ChatGPTFetch website traffic data from Google Analytics 4 for a date range. Returns daily rows (oldest first) or, with aggregate=true, one row of totals for the range: users, sessions, pageviews, bounce rate, average session duration and engagement rate.
get_ga4_channels
ChatGPTBreak down website traffic by acquisition channel from GA4: sessions, users, pageviews, bounce rate, avg session duration, key_events (total conversions) and conversion_rate (key events / sessions, fraction 0–1) per channel — Organic Search, Direct, Social, Referral, Paid Search, Cross-network, Email, Display.
get_ga4_custom_report
ChatGPTReturns a GA4 report with up to nine dimensions and ten metrics, filters, sorting and optional previous-period or previous-year comparisons. Names are GA4 API names. Rows are keyed by those names, dates use YYYY-MM-DD and rates are fractions from 0 to 1. Totals are whole-period GA4 totals with deduplicated users, rather than sums of row users.
get_ga4_ecommerce
ChatGPTWhat an online shop sold, from GA4 e-commerce events, for a date range. breakdown=totals (default): sessions, purchases, revenue, add_to_carts, checkouts, aov (average order value) and conversion_rate (purchases / sessions, fraction 0–1). daily: the same per day, for trend charts. channels: purchases, revenue and sessions per GA4 channel group (Organic Search, Paid Search, Paid Social, Organic Social, Direct …) — which channel sells, last click. products: top products by revenue (item, purchased, revenue, viewed, added_to_cart). Revenue is in the property currency as the shop reports it (usually with VAT, without shipping). The e-commerce client pages (business_model=ecommerce) read orders and revenue from here.
get_ga4_events
ChatGPTReturns GA4 event names, counts and users for a date range. key_events_only limits the results to conversion events.
get_ga4_funnel
ChatGPTA GA4 funnel: how many users reached each step and where they left — e.g. view_item → add_to_cart → begin_checkout → purchase, or session_start → a page view on /pricing → generate_lead. A step is an event name and/or filters on fields such as pagePath or deviceCategory. Per step: active_users, completion_rate (share of the step's users who reached the next step), abandonments, abandonment_rate; overall_conversion_rate = last step ÷ first. Optional breakdown by one dimension (deviceCategory, country, sessionDefaultChannelGroup …). GA4 marks its funnel API alpha.
get_ga4_landing_pages
ChatGPTReturns page-level GA4 traffic with page title, path, pageviews and sessions.
get_ga4_metadata
ChatGPTThe dimensions and metrics this GA4 property accepts: the property's own custom dimensions and metrics (customEvent:…, customUser:…, customItem:…), its key events (each also gives the metrics keyEvents:<event>, sessionKeyEventRate:<event>, userKeyEventRate:<event>) and the standard GA4 fields. Without search: every standard API name grouped by category. With search: the matching fields with UI name, category, type and description.
get_ga4_new_vs_returning
ChatGPTBreak down website visitors into new vs returning users from GA4. Returns sessions, users, engagement rate, and average session duration for each group.
get_ga4_pages
ChatGPTGet the top website pages from GA4 ranked by pageviews, with page title, path, pageviews and sessions.
get_ga4_realtime
ChatGPTWho is on the website right now, from GA4 Realtime: active users in the last 1–30 minutes, optionally with event count, page views and key events, by country, city, deviceCategory, platform, unifiedScreenName (page title), eventName or minutesAgo. Realtime has its own, smaller set of dimensions and metrics; dimensions like source, landing page or custom dimensions are not available here.
get_gsc_brand_queries
ChatGPTReturns Google Search Console brand clicks, impressions, total clicks and impressions, brand_click_share_pct and top brand queries. brand_keyword selects the term; the project name is the default.
get_gsc_keyword_positions
ChatGPTDaily Google ranking position of a fixed set of search terms from Search Console — the data source for a "SEO positsioonid" rank-trend chart. Returns one row per day: {date, "<keyword>": position|null, ...} — null = no impressions that day (a gap, not rank 0). Position is the GSC daily average for the EXACT term (case-insensitive), so it is stable and comparable month to month. Note GSC data lags ~2 days. Filter by country (alpha-3, e.g. "est") to see one market.
get_gsc_top_pages
ChatGPTGet the best-performing website pages in Google search ranked by clicks. Returns URL, clicks, impressions, CTR, and average position for each page.
get_gsc_top_queries
ChatGPTGet the top Google search queries that bring visitors to the website. Returns keyword, clicks, impressions, CTR, and average position. Filter by country (ISO-3166 alpha-3, e.g. "fin" for Finland, "est" for Estonia) to see per-market keywords, and/or by page (substring, e.g. "/fi/") to scope to one section.
get_my_tasks
ChatGPTReturns the authenticated agent's unfinished strategy tasks, planned channel activities, plan pillar and client approval state. The optional channel selects a recurring job's channel; an empty queue includes a suggested next step.
get_onboarding_status
ChatGPTReturns the project's onboarding checklist, completion state, questions, connection status and recurring-work suggestions. This tool costs no credits.
get_plan_document
ChatGPTReturns the team's full Markdown marketing-plan document, update time, last subagent-task synchronization time and dirty flag. dirty=true means the document changed after the last synchronization. The document is editable on the plan page and downloadable as PDF.
get_search_console
ChatGPTReturns daily Google Search Console clicks, impressions, click-through rate and average position. aggregate=true returns totals for the period; metric selects one metric.
get_seo_dashboard
ChatGPTReturns an agent dashboard's SEO client view, section schemas, content timestamps, open client requests and unread messages. Includes provider data, section ownership, refresh cadence and a data-source map. Defaults to the authenticated agent's dashboard.
get_social_engagement_chart
ChatGPTReturns chart-ready engagement per post for Facebook and Instagram, sorted descending. Facebook engagement sums reactions, comments and shares; Instagram uses total interactions. The result contains labels and one dataset per channel.
get_social_mentions
ChatGPTAggregates brand mentions across Reddit, YouTube, LinkedIn, Facebook, and Bluesky into a single normalized feed. Each mention includes platform, author, content (truncated to 500 chars), url, posted_at, and sentiment (positive/negative/neutral via keyword heuristic). Reddit + YouTube run via system credentials; LinkedIn/Facebook/Bluesky run only when the project has a connected account of that type. Sources fail per-source — one broken source returns an entry in errors[] but the rest still return.
get_strategy_status
ChatGPTReturns a strategy card's title, mode, tasks and completion state. is_skipped=true means a person deactivated the task; it is not actionable for an agent. Progress counts skipped tasks as resolved alongside completed tasks.
get_team_capabilities
ChatGPTReturns available marketing-agent roles, their capabilities, connected and missing data sources, recommended skill metadata and whether the project has a manager dashboard.
get_team_overview
ChatGPTReturns the manager dashboard's team status, agent progress, highest-priority issues, marketing-plan coverage and child dashboard tokens.
get_team_skill
ChatGPTReturns the full Markdown content of a project team skill. Defaults to its canonical version, or its latest version when none is canonical.
get_usage_summary
ChatGPTGet credit usage statistics: daily usage breakdown, top tools by usage count, and usage by bot type.
inspect_draft
ChatGPTReturns draft content, review status and linked social post details without changing the draft.
inspect_gsc_url
ChatGPTReturns Google's index verdict for up to 20 project URLs, including coverage, robots, crawl state, canonical URLs, sitemaps, referring pages and mobile/rich-result verdicts. The provider quota is 2000 inspections per property per day.
inspect_runs
ChatGPTInspect failed and stalled tool runs for this project: A2A tasks and failed MCP tools/call (an MCP error carries its task_id). Returns sanitized root-cause categories and recommended actions without task inputs, raw results, credentials, callback URLs, IPs, or automatic replay.
invalidate_dashboard_cache
ChatGPTClear all cached widget data for a dashboard, forcing the next view to refetch live data.
invite_client_person
ChatGPTEmails a project member a one-time dashboard sign-in link. Owners can approve work and spending decisions. Repeating the request for the same email sends a new link.
invite_dashboard_client
ChatGPTSends an email invitation with a sign-in link to a public dashboard in this project. Creates or updates the client person and grants the selected project role. Repeating the call sends a new email; the project invitation rate limit applies.
invite_teammate
ChatGPTShare full access to THIS project with another person's Claude Cowork — fully A2A, no web page. Creates a team invite and returns an invite_token + a ready recipient_instruction. The recipient's OWN agent accepts by POSTing {invite_token, name} to /api/v1/a2a/accept-invite, which provisions a claude_cowork agent scoped to the SAME project and returns its client_id + client_secret + mcp_url. ALSO does credential recovery: if the email already belongs to a teammate who lost their secret, accepting REFRESHES it (client_id + connections stay; response sets recovery:true).
link_to_manager
ChatGPTAttaches an agent dashboard to a manager dashboard, or detaches it. Both dashboards belong to the same project. Sets the parent and agent key for team rollups and shared plan context.
list_change_impacts
ChatGPTReturns measured outcomes of project changes with baseline and follow-up metrics, assessment status and the next scheduled measurement time.
list_client_people
ChatGPTList the client's people who can sign in to this project's dashboards (e-mail, role, when they last signed in).
list_connections
ChatGPTList all currently connected services for this project. Returns each connection's service type, status (connected/disconnected/error), connection date, last sync time, and whether it needs configuration.
list_creative_assets
ChatGPTLists project photo-bank images, brand assets and client uploads, newest first, with IDs, sources, signed URLs, dates, sizes, tags, people/consent flags and publication eligibility. Includes photo-request status and received-photo counts. This tool lists existing files.
list_drafts
ChatGPTLists project content drafts, newest or most urgent first. Status filters support pending, changes_requested, approved, scheduled, rejected and published. Absent status selects pending and changes_requested.
list_gsc_sitemaps
ChatGPTThe sitemaps submitted in Search Console for the connected property: path, type, last submitted and last downloaded by Google, pending/processing flag, errors and warnings count, and submitted URL counts per content type.
list_integrations
ChatGPTBrowse the catalog of marketing integrations (analytics, search, advertising, social, SEO, CMS, e-mail marketing, reviews, forms, Google Workspace) with authentication type (api_key, oauth), required credentials, category and setup instructions. Filter by category or auth type.
list_plan_activities
ChatGPTList marketing plan activities for this project (the Annual/Monthly calendar data), ordered by date. Optionally filter by month (1-12) or status. If an activity is linked with task_ref, its status/attention are derived from that strategy task.
list_scheduled_reports
ChatGPTList this project's recurring reports: title, schedule, recipients, whether it is on, last and next run, and the start of the last result (an "ERROR: …" result means the last run failed).
list_site_file_backups
ChatGPTLists recent website-file backups and changes, newest first, with path, time, note and rollback status. Supports a path filter.
list_site_files
ChatGPTLists a website folder over SFTP. Allowed paths: wp-content/themes/, wp-content/mu-plugins/. Extensions: php, css, js, json, html, txt, svg, xml. Maximum 512 KB. wp-config.php, .htaccess, uploads and plugins are excluded.
list_team_skills
ChatGPTList the project's shared team skills visible to you — every slug with its channel, versions, who contributed each, and which version is canonical (the manager's pick). Channel agents see global skills + their own channel's; orchestrators see all.
mark_client_messages_read
ChatGPTMarks client messages read on one dashboard, selected by explicit message IDs or one thread. Preserves replies, task status and unanswered status. Messages outside the accessible dashboard are excluded.
mark_draft_published
ChatGPTRecords a draft without a linked social post as published after publication elsewhere. This operation posts no content to a channel. Linked social posts require the unlocked manager dashboard; the submitting agent cannot mark its own draft published on a client-approved dashboard.
mark_plan_tasks_synced
ChatGPTManager-only bookkeeping: declare that subagent tasks are now re-aligned with the current marketing-plan document. Clears the "tasks not synced" flag on the dashboard and archives the team-memory reminder.
memory_archive
ChatGPTArchives a memory entry within the authenticated role's write scope. Archived entries remain searchable and are excluded from the bootstrap context.
memory_bootstrap
ChatGPTReturns a role-scoped workspace context within an approximately 2500-token budget: global constraints and facts, channel task state, recent decisions, results and lessons. Orchestrators can select a channel role.
memory_get
ChatGPTReturns one memory entry by ID when it is visible to the authenticated role.
memory_review
ChatGPTReturns duplicate, expired and stale high-priority memory entries for an orchestrator's review.
memory_search
ChatGPTSearches visible workspace memory entries, including archived entries, by text and optional filters.
memory_update
ChatGPTUpdates allowed fields of an existing memory entry, including title, content, status, pin, expiry and linked task.
memory_write
ChatGPTCreates a role-scoped memory entry: fact, constraint, decision, result, lesson or task state. Constraint writes require an orchestrator or human. Duplicate detection returns a supersede suggestion without creating a second copy.
monitor_keyword_serp
ChatGPTCheck current Google search results (SERP) for specific keywords. Returns top-ranking URLs, titles, and snippets for each keyword. Configurable by location (default: Estonia), language (default: et), and device type.
monthly_marketing_report
ChatGPTGenerate a comprehensive monthly marketing report in a single call. Automatically gathers data from all connected marketing sources: GA4 website traffic and channel breakdown, Google Search Console top queries and top pages, social media metrics (Facebook, LinkedIn, Twitter — whichever are connected), and Google/Meta ad campaign performance. Returns a structured report with sections for each data source, including which sources were available and which were not connected. Covers the specified month or defaults to last 30 days.
pause_strategy_card
ChatGPTPauses a strategy card, excluding it from active priority counts while preserving its tasks.
promote_skill
ChatGPTMarks a team skill version as canonical and demotes the previous canonical version. Restricted to managers.
propose_plan_input
ChatGPTBottom-up: a teammate agent proposes an input/suggestion into the manager's shared marketing plan (e.g. SEO agent proposes a content priority). Appears in the manager Command Center under "Agentide sisendid plaani" for the manager to accept or decline. Status starts as "proposed".
propose_plan_update
ChatGPTCreates a proposed replacement marketing-plan snapshot with a change summary and optional source document. The growth lead reviews and applies it before it becomes an active version.
read_dashboard
ChatGPTRead a FULL dashboard — layout AND live widget data — in one call. Integration widgets are fetched server-side with the same caching as the public page. Returns compact JSON ordered by widget position.
read_site_file
ChatGPTReturns a theme or mu-plugin file over SFTP with its content, SHA-256 hash and recent backups. Allowed paths: wp-content/themes/, wp-content/mu-plugins/. Extensions: php, css, js, json, html, txt, svg, xml. Maximum 512 KB. wp-config.php, .htaccess, uploads and plugins are excluded.
reassign_strategy_card
ChatGPTMoves a strategy card to another agent dashboard under the same manager, preserving its content and task completion states.
record_kpi_values
ChatGPTWrite monthly values of AI osakond plan KPIs the platform cannot read from a connection — keywords in the top ten, AI mentions, social reach, and anything else without a live metric. values: [{kpi_id, month: "YYYY-MM", value}]. KPIs with a live metric (GA4 leads, Search Console clicks, Google/Meta Ads cost and conversions) update themselves; writing them here only fills months the source cannot answer. This is data, not a plan change: no version is made.
reject_draft
ChatGPTRejects a draft with optional feedback and cancels its linked social post before publication. Publishing or published social posts cannot be rejected here.
reopen_strategy_card
ChatGPTReopens a strategy card in the active work list while preserving tasks.
repair_connection
ChatGPTRetries a connection with a bounded read-only provider check. Marks it connected on verified success and preserves status on temporary or unsupported failures. Credentials are retained without rotation.
reply_to_client
ChatGPTPosts a reply in a dashboard task or general thread. resolve_task=true clears the human-needed label and returns the task to AI mode. Opted-in clients receive a batched notification email.
request_client_photos
ChatGPTPosts a photo request to a client dashboard thread and sends the standard notification email. Requests include subject, purpose, count, deadline and consent information. Unanswered duplicate requests are suppressed for seven days. Department dashboards are excluded.
request_draft_changes
ChatGPTReturns a draft for changes with feedback and synchronizes the linked social post review status. Publishing or published social posts cannot change through this operation.
restore_site_file
ChatGPTRestores the file state before a stored backup over SFTP, removing a file that the original write created. Backs up the current state and performs write health checks, so the restore can itself be undone. Changes follow the project's approval policy.
resume_strategy_card
ChatGPTResumes a paused strategy card in active priority counts.
revise_draft
ChatGPTRevises text, media or scheduling on a draft returned for changes. Preserves draft and social-post IDs and archives the previous revision. Pre-review failure returns qa_failed without changing the draft. Success returns it to pending approval or restarts its veto window and synchronizes the linked post.
schedule_draft
ChatGPTRecords a scheduled time for a draft without a linked social post. Linked social posts require scheduling in the unlocked manager dashboard. The submitting agent cannot schedule its own draft on a client-approved dashboard.
score_citability
ChatGPTCitability score 0–100 of one or more public pages: how easily an AI answer engine (ChatGPT, Perplexity, Gemini, Google AI Overviews) can lift a citable fact from the page. Checks answer-first structure (H1 + direct answer paragraph), concrete statistics, author attribution, freshness (published/modified date), Q&A blocks (FAQPage / question headings), structure (H2s, lists, tables, length), entity schema (Organization/LocalBusiness/Article/Service JSON-LD) and crawlability (noindex, canonical). Returns per-page score + grade + check details + recommendations, and average_score across pages. Typical input: the homepage and the main service page.
scrape_website
ChatGPTScrape and extract data from any public website. Can extract text content, meta tags (title, description, OG tags), headings structure, links, and images. Supports JavaScript-rendered pages and custom CSS selectors for specific elements.
search
ChatGPTSearch the SharksAPI.AI tool catalog and connected project capabilities.
search_ariregister_by_name
ChatGPTSearch the Estonian Business Registry by company name keyword. No credentials needed — uses the public autocomplete endpoint. Returns up to 10 active companies with name, reg_code, and address.
search_ariregister_companies
ChatGPTSearch the Estonian Business Registry (ariregister.rik.ee) for companies by EMTAK sector code and annual turnover range. Returns name, reg_code, address, email, phone, emtak_code, turnover (EUR, from official annual reports). Companies without a published annual report are excluded.
search_web_mentions
ChatGPTDeprecated alias for brand-mention retrieval across Reddit, YouTube and connected LinkedIn, Facebook and Bluesky accounts. Supports look-back windows, source selection and domain exclusions.
set_marketing_plan
ChatGPTCreate or update the shared marketing plan on a MANAGER dashboard — the team's common foundation. Holds the north-star goal, KPIs and strategic pillars. Re-calling replaces the active plan for that manager.
set_project_profile
ChatGPTSaves supplied project onboarding fields while retaining earlier answers for omitted fields. Returns the updated onboarding status.
set_strategy_card_severity
ChatGPTSets a strategy card priority severity.
start_connection
ChatGPTInitiates an OAuth sign-in or credential form for a service. Returns an authorization URL for the project owner to complete in a browser and emails it to the owner. Reports existing connections or pending requests without duplicating them.
submit_ad_creative
ChatGPTCreates a Meta ad creative or replacement version on the department dashboard for client approval. Requires a complete brand guide. Submission does not launch an ad; existing ads continue until their replacement is approved and launched.
submit_draft
ChatGPTSubmits marketing content for review. Pre-review can return qa_failed without creating a draft. Otherwise the draft waits for approval, auto-approves under autopilot or follows a veto window. require_approval preserves human review on autopilot only for recognized manager-decision topics in the title.
submit_indexnow
ChatGPTNotifies IndexNow search engines of up to 100 changed URLs on one site connected to this project. Requires an IndexNow key file on that host; the first call returns its filename and content or confirms it is live. Google does not use IndexNow.
update_ad_creative
ChatGPTRecords an ad creative's external Meta status, ad ID, text synchronization and performance results. Launch status requires prior client approval. Recording a launched replacement retires the previous version.
update_client_request
ChatGPTMove a client request along on the AI osakond dashboard: status (agent_working | in_plan | needs_client_approval | done | declined — needs_growth_lead only the growth lead clears), kind (event | campaign | event_campaign) and status_note (one line the client sees under the row, e.g. "4 postitust sisuplaanis").
update_dashboard
ChatGPTUpdates dashboard display settings, name, description, dates and display widgets. This tool does not accept password changes.
update_plan_activity
ChatGPTUpdate a plan activity — change its title, months, date, channel, linked draft, notes or task_ref. If task_ref is linked, status becomes derived from the strategy task; manual status updates are blocked until task_ref is cleared with null.
update_plan_document
ChatGPTCreates or replaces the complete Markdown marketing-plan document. Unless mark_synced is true, flags tasks as unsynchronized and adds a team-memory reminder. The document is also editable from the project plan page.
update_seo_dashboard
ChatGPTReplaces one section of the SEO client dashboard with the supplied data. An optional market selects a market-specific version. delete=true removes the override and restores server or task data. Validation errors identify the affected field and expected shape.
update_strategy_card_text
ChatGPTReplaces the Markdown strategy text of a card while preserving its tasks and status.
update_strategy_task
ChatGPTToggle a task on a strategy card — mark as completed or pending. Agents may update any strategy task they can access, including human-controlled tasks; completed tasks are recorded with completed_by=ai. Returns the updated task state. Optionally set note (free text) and label (one of: blocked, needs_human, needs_access, in_progress) to annotate task state.
validate_schema_type
ChatGPTValidate a specific Schema.org type (e.g. Product, Article, FAQPage, LocalBusiness) on a webpage. Checks if the schema exists, scores completeness by checking required and recommended fields, and provides a ready-to-use JSON-LD example if the schema is missing.
write_site_file
ChatGPTReplaces or creates one theme or mu-plugin file over SFTP. Backs up the previous version, checks PHP syntax and verifies the uploaded hash. Automatically rolls back a new home-page 5xx or PHP fatal error. Changes follow the project's approval policy. Allowed paths: wp-content/themes/, wp-content/mu-plugins/. Extensions: php, css, js, json, html, txt, svg, xml. Maximum 512 KB. wp-config.php, .htaccess, uploads and plugins are excluded.
write_weekly_summary
ChatGPTCreates or replaces this week's owner-facing summary of completed work, measured results and next steps. The summary appears on the dashboard's Today page and in the Monday email.
