This page lists every tool the Floyi MCP server exposes, grouped by where it sits in your workflow. You don’t need to memorize any of this — the server is self-describing, so your AI assistant fetches the full tool list with parameter schemas the moment it connects. Use this catalog to understand what’s possible and what each tool costs.
Last updated: 2026-10-12 (103 tools)
How to read the tables:
Credits — Free means the tool never spends credits. Tools marked Credits trigger a configured paid generation or data action; the row states the current pricing model, including MCP-specific pricing where applicable. Paid tools return a cost or estimate; use floyi_credits for the authoritative current balance. See how credits work over MCP.
Scope — the permission the connection needs for the call to succeed. OAuth connections (Claude, ChatGPT, Codex) carry the full standard permission set shown on the approval screen, so every scope below is covered. API keys hold the scopes selected at creation in Settings > API Keys (not currently editable afterward) — your client may still list tools the key cannot execute.
Orientation tools your assistant should use early in a session.
Tool
What it does
Credits
Scope
floyi_get_workspace
Show the Personal or team workspace permanently bound to the API key. Call before brand discovery.
Free
user:read
floyi_capabilities
Floyi’s ground rules for agents: irreversible actions, real generation timings, hard limits, and which tool does what. Assistants should read this first.
Free
user:read
floyi_credits
Check remaining credits across all pools, plus plan and workspace.
Free
user:read
floyi_list_models
List available AI models with their credit cost multipliers.
Free
user:read
floyi_check_task
Poll the progress of a brief or draft generation task.
Create a brand from a website URL using Floyi’s scrape + AI analysis.
Free
brands:write
floyi_update_brand
Update brand foundation fields.
Free
brands:write
floyi_set_brand_stage
Route the brand through the app’s Continue transitions, including Resources Only, site architecture + resources, or architecture-only. Forward by default; a guarded recovery path can return clustering/map building to Topical Research, but cannot revert from Topical Authority.
Read the site architecture, pages by kind, and the available site-type options.
Free
brands:read
floyi_set_site_type
Set the brand’s site type (local, services, SaaS, e-commerce, content).
Free
brands:write
floyi_generate_site_architecture
Generate site architecture pages from your business inputs for local, services, SaaS, or e-commerce sites. Content-only sites take their structure from the topical map and do not use this generator.
Free
brands:write
floyi_update_site_page
Update one page’s primary tracking query or authority-tracking status.
Free
brands:write
floyi_edit_site_pages
Add, update, or delete architecture pages, or extract a location taxonomy from a source URL.
Research config, plan allocation status, and where you are in the 4-step research workflow.
Free
research:read
floyi_set_research_setup
Set the core topic, seed keywords, and persona selection.
Free
research:write
floyi_generate_research
Run one of the 4 research generation steps. Topic steps are free within your plan’s research allocation; the keyword step charges credits (per topic x model multiplier).
Free / Credits
research:write
floyi_get_research
Read the topical research tree (or just its stats).
Free
research:read
floyi_modify_research
Add, rename, move, merge, or delete research nodes and edit their keywords.
Free
research:write
floyi_research_dedup
Free embedding-based scan for near-duplicate topics across the tree — feeds merge operations.
Free
research:write
floyi_run_ai_search_gaps
Run AI Search Gaps discovery: persona-grounded questions are asked across AI search engines and matched against your research tree. Pricing includes fixed analysis stages plus 5 queries per selected engine; estimate_only returns the exact price first.
Credits (fixed + per engine)
research:write
floyi_check_ai_search_gaps
Poll a discovery run, read its gap topics when complete, or list a brand’s runs.
Free
research:read
floyi_apply_ai_search_gaps
Add reviewed gap topics into the research tree at their suggested placement, or take a previously added one back out.
Takes the research tree’s keywords through SERP-based clustering — the step before map building.
Tool
What it does
Credits
Scope
floyi_get_clustering_status
Clustering state, clusterable keyword count, and the exact cost before you start.
Free
clustering:read
floyi_start_pipeline_clustering
Start the SERP fetch + clustering run. Requires a spend confirmation; charged per keyword only on success. Recluster mode (recompute from stored SERPs) is free.
Credits (per keyword)
clustering:write
floyi_check_clustering_progress
Poll progress or cancel the run.
Free
clustering:read
floyi_get_clusters
Read cluster groupings for review, with search and filtering.
Free
clustering:read
floyi_edit_clusters
Targeted cluster merge / move / remove edits — the same validation as the app’s cluster editor.
Stage-aware status: prerequisites, per-topic progress, running tasks, and which actions are available or blocked (with reasons). Call this first at the map stage.
Free
maps:read
floyi_generate_map_hierarchy
Generate or rebuild the topical map structure from the clustering run. Asks for confirmation before overwriting.
Free
maps:write
floyi_generate_content_info
Generate titles, search intent, buyer journey stage, content type, and snippets per topic.
Credits (per topic)
maps:write
floyi_generate_url_slugs
Generate URL slugs for topics — fill missing only, or regenerate all with confirmation. The brand’s selected resource URL prefix is baked into generated slugs.
Free
maps:write
floyi_modify_map
Targeted map edits: move a topic, rename a branch, delete a topic (with confirmation). Every edit snapshots the map first.
Structure management once the brand reaches Topical Authority.
Tool
What it does
Credits
Scope
floyi_search_topics
Search topics in the map by keyword, with content status and each topic’s search intent and funnel stage as the Planner shows them, including whether you set them by hand.
List the active hierarchy overrides layered on the base map.
Free
maps:read
floyi_clear_overrides
Undo hierarchy overrides — specific nodes or all.
Free
maps:write
floyi_add_silo
Research a new topic silo for the map. Supports estimate_only to preview cost without starting.
Credits (model-based)
maps:write
floyi_silo_status
Check silo research progress.
Free
maps:read
floyi_approve_silo
Approve and integrate the researched silo into the map.
Free
maps:write
floyi_discard_silo
Discard a pending silo.
Free
maps:write
floyi_manage_keywords
List, add, or delete anchor keywords on a map node.
Free
authority:write
floyi_update_url_slug
Update a single node’s URL slug.
Free
authority:write
floyi_fetch_node_metrics
Fetch search volume, CPC, and competition onto topic nodes. Supports an estimate-only call; pricing is 5 keywords per credit at the base rate, rounded up.
Find gaps across the map: missing content, weak coverage, low rankings. Each gap includes its Planner search intent and funnel stage.
Free
authority:read
floyi_get_pillars
Pillar-level authority breakdown: TAS, coverage, visibility.
Free
authority:read
floyi_get_competitors
Competitor comparison metrics.
Free
authority:read
floyi_get_internal_links
Internal link suggestions for a topic, grouped by relation with relevance and reasoning.
Free
authority:read
floyi_get_ai_visibility
AI search visibility: where you (or a competitor domain) are cited or mentioned in AI Overviews, AI Mode, Gemini, and ChatGPT results.
Free
authority:read
floyi_get_ai_responses
Read the stored AI Overview, AI Mode, Gemini, and ChatGPT responses for up to 25 map topics per call: every cited source (URL and title), your brand’s status in each response, fetch dates, and the searches ChatGPT and Gemini ran. The full answer text is optional. The same data the app shows when you open a topic’s AI response.
Free
authority:read
floyi_get_topic_serps
Read the stored Google results for up to 25 map topics per call: the query each SERP is for, its fetch date, up to 20 results per topic (position, URL, domain, title, and optional snippet), and SERP features such as People Also Ask. The same SERPs the Planner shows. Never fetches new data.
Free
authority:read
floyi_get_gsc_insights
Read connected Google Search Console summaries, snapshots, query trends, and page performance.
Free
authority:read
floyi_get_ta_settings
Read the aliases, query strategy, schedule, locale, and engine settings that define authority tracking.
Free
authority:read
floyi_update_ta_settings
Update authority tracking settings. Enabling a recurring schedule requires explicit approval because scheduled runs spend credits.
Free
authority:write
floyi_refresh_authority
Fetch fresh SERPs and AI Overviews, optionally track AI Mode, ChatGPT, and Gemini, then recompute authority. Requires cost confirmation; each enabled optional engine adds the same per-topic cost as the SERP run.
Credits (per topic x enabled sources)
authority:write
floyi_recompute_authority
Recompute authority scores from existing stored data without fetching fresh SERPs.
Free
authority:write
floyi_check_authority_task
Poll authority task progress.
Free
authority:read
floyi_classify_intents
Classify search intent (Informational, Commercial, Transactional, Navigational, Generative) and funnel stage (TOFU, MOFU, BOFU) for unclassified topics in the map. Values you set by hand in the Planner are never overwritten.
Read stored standard SERP results and stored AI-response availability for competitor selection, or fetch fresh standard SERP results. Set include_ai_sources to also get each stored AI response’s cited sources.
Free (fresh fetch: 1 credit, charged only on success)
briefs:read
floyi_get_knowledge_base
List knowledge base categories and documents for brief scoping (Step 3).
Free
brands:read
floyi_add_kb_document
Import a knowledge-base document from a URL or pasted text for use in briefs and drafts.
Free
brands:write
floyi_get_kb_document
Read a knowledge-base document’s full text and metadata.
Free
brands:read
floyi_manage_kb
Categorize or delete knowledge-base documents and create, rename, or delete categories.
Free
brands:write
floyi_generate_brief
Generate a content brief with all four selection steps: competitors, personas, keywords + knowledge base, and links. Optional fresh AI Mode, ChatGPT, and Gemini inputs add 1 credit each. include_brand (default on) is the app’s Include My Brand toggle for roundup, comparison, and review briefs: your brand is added as a compared item only when your brand foundation states a product or service that fits the comparison, so a content-only brand is never written up as a product. For map topics, the brief follows the topic’s Planner search intent and funnel stage: values you set by hand are always used, and other values are the starting point unless the search results clearly point elsewhere.
Credits (x model multiplier + selected engines)
briefs:write
floyi_cancel_task
Cancel a pending brief generation task and refund its reserved credits. Draft cancellation is not exposed.
Free
briefs:write
floyi_list_briefs
List briefs with status.
Free
briefs:read
floyi_get_brief
Read the full brief: outline and brief content (curated version if one exists). Also returns brand_inclusion: whether your brand is one of the compared items (mode include, exclude, or neutral), the offering used, and the reason.
Free
briefs:read
floyi_edit_brief
Targeted brief curation edits — versioned and revertible.
Free
briefs:write
floyi_get_optimizer_data
Content Optimizer terms (ranked by relevance, with usage ceilings) and entities for a brief.
Generate a first draft from a completed brief, with intent, custom prompt, personas, and optional Research Agent or intro/key-takeaways specialists. Conversion Coach is automatic for architecture pages.
Credits (base + specialists, x model multiplier)
content:write
floyi_list_articles
List valid completed drafts (draft_done) only. Ungenerated ready scaffolds are excluded; an empty list means no drafts/articles.
Free
content:read
floyi_get_article
Read a valid completed draft section by section — always the exact text the app renders (polished revision ahead of raw draft), with internal links resolved to real URLs. Every section also lists the images placed in it in the app (images, with source URL and alt text); intro and key-takeaways images and the featured image URL are returned alongside. The Featured Image section is a heading whose only content is its image, so empty text there is expected. Research sources and competitor pages ride along as structured metadata, including whether the user deleted the rendered Sources block. Sections deleted in the app editor are soft-deleted server-side and never returned. A scaffold returns ARTICLE_NOT_GENERATED; editor-only rich-text changes may return content_location: "editor" when the latest prose cannot be safely projected.
Free
content:read
floyi_edit_draft_section
Make a surgical plain-text edit to one draft section’s human-revision layer. Images placed in the section in the app are always kept in place (the response reports images_preserved); the tool never removes or moves an image, so removing one stays an app-editor action. Refuses while the draft is generating or open in the app editor.
Free
content:write
floyi_edit_article_block
Edit the article’s intro or key-takeaways block as plain text, or remove the intro, key-takeaways, or Sources block the way the app editor does (the deletion is recorded so publishing and exports never re-add it). Images inside the block are kept in place on a replace. Refuses while the draft is generating or open in the app editor.
Free
content:write
floyi_edit_draft_structure
Add, rename, or remove an H2/H3 draft section as one coordinated brief+draft operation: the curated brief is updated in the same edit (versioned), so the change survives regeneration first-class. Each FAQ is its own H3 section, so this is also how an agent adds an FAQ. Removing a section also removes any images placed in it (the response reports images_removed). Same safety contract as the other draft edit tools.
Free
content:write
floyi_get_draft_quality
Read a draft’s Page Quality Scorecard (overall score, bucket, six dimensions with reasoning and evidence, including answer first: which sections open with a direct answer to their heading) plus the brief’s information-gain targets.
Free
content:read
floyi_reanalyze_draft_quality
Re-score the draft’s current content against the quality rubric. Same price as the app’s Re-analyze button; a failed run never charges.
10 credits
content:write
floyi_get_draft_optimization_score
Read the draft’s Optimizer score (the 0-100 gauge in the Content Editor) with its six factor scores, missing and overused terms, long paragraphs, and competitor benchmarks. Same model and same number as the gauge for the saved document; a draft never opened in the app is scored from its sections and labeled provisional.
Free
content:read
floyi_set_editorial_state
Set the review state to Awaiting Review, Needs Editing, Approved, or Published. The Published state records a fact; it does not publish to a CMS.
Free
content:write
floyi_check_pipeline
Content pipeline status across brands: briefs, drafts, and failures.
Free
content:read
floyi_list_wordpress_connections
List connected WordPress sites.
Free
content:read
floyi_publish_wordpress
Publish an article to WordPress — defaults to WordPress-side draft status.
Free
content:write
floyi_check_wordpress_task
Poll a WordPress publish task.
Free
content:read
floyi_list_github_connections
List connected GitHub repositories with their publish defaults (branch, content path, file format).
Free
content:read
floyi_publish_github
Publish an article to a connected GitHub repo as Markdown/MDX. Commits directly to the configured branch with no draft staging and does not mark the article Published until the live deployment is confirmed separately.