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-07-18 (99 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 your API key needs for the call to succeed. Your client may still list tools the key cannot execute. Scopes are selected when a key is created in Settings > API Keys and cannot currently be edited afterward.
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. | Free | briefs:read |
| Tool | What it does | Credits | Scope |
|---|
floyi_list_brands | List all brands in the workspace with summary stats. | Free | brands:read |
floyi_get_brand_overview | Detailed brand overview: context, map summary, authority metrics, pipeline health. | Free | brands:read |
floyi_create_brand | Create a new brand. | Free | brands:write |
floyi_create_brand_from_url | 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. | Free | brands:write |
| Tool | What it does | Credits | Scope |
|---|
floyi_generate_personas | AI-generate and add 1–5 buyer personas, optionally steered with your input. Existing personas are not replaced. | Free | brands:write |
floyi_edit_persona | Update or delete a buyer persona. | Free | brands:write |
floyi_list_personas | List buyer personas (also used to pick personas for briefs). | Free | brands:read |
| Tool | What it does | Credits | Scope |
|---|
floyi_get_site_architecture | 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. | Free | brands:write |
| Tool | What it does | Credits | Scope |
|---|
floyi_get_research_setup | 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. | Free | research:write |
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. | Free | clustering:write |
| Tool | What it does | Credits | Scope |
|---|
floyi_get_map_status | 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. | Free | maps:write |
floyi_check_map_task | Poll map-building and persona task progress. | Free | maps:read |
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. | Free | maps:read |
floyi_modify_hierarchy | Add, rename, move, combine, archive, or restore hierarchy nodes (as revertible overrides). | Free | maps:write |
floyi_get_overrides | 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. | Credits (batched keywords) | authority:write |
| Tool | What it does | Credits | Scope |
|---|
floyi_find_content_gaps | Find gaps across the map: missing content, weak coverage, low rankings. | 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_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 and funnel stage for unclassified topics in the map. | Free | authority:write |
Brief generation mirrors the app’s 4-step modal: competitors, personas, keywords + knowledge base, links.
| Tool | What it does | Credits | Scope |
|---|
floyi_get_serp_data | Read stored standard SERP results and stored AI-response availability for competitor selection, or fetch fresh standard SERP results for free. | Free | 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. | 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). | 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. | Free | briefs:read |
| Tool | What it does | Credits | Scope |
|---|
floyi_generate_draft | 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, plus its integrated body. 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. 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. Refuses while the draft is generating or open in the app editor. | Free | content:write |
floyi_get_draft_quality | Read a draft’s Page Quality Scorecard (overall score, bucket, five dimensions with reasoning and evidence) 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_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. | Free | content:write |
floyi_check_github_task | Poll a GitHub publish task. | Free | content:read |
| Tool | What it does | Credits | Scope |
|---|
floyi_get_content_guide | Read a brand’s content guide entries. | Free | content:read |
floyi_add_content_guide_entry | Add a terminology, compliance, competitor-policy, messaging, or boilerplate rule. | Free | content:write |
floyi_edit_content_guide_entry | Update or delete a content guide entry. | Free | content:write |
Runs a query across AI search engines and synthesizes per-engine analysis, comparative synthesis, and strategic recommendations.
| Tool | What it does | Credits | Scope |
|---|
floyi_run_airs_analysis | Run an AIRS analysis for a query. Supports estimate_only to preview cost without starting. | Credits (on completion) | toolbox:write |
floyi_check_airs_analysis | Poll analysis progress. | Free | toolbox:read |
floyi_get_airs_result | Get results by stage — defaults to the strategic recommendations. | Free | toolbox:read |
floyi_list_airs_analyses | Browse past analyses. | Free | toolbox:read |
Cluster any keyword list — independent of the brand pipeline.
| Tool | What it does | Credits | Scope |
|---|
floyi_start_clustering | Start a clustering run for a keyword list. Supports estimate_only to preview cost without starting. | Credits (per keyword) | clustering:write |
floyi_check_clustering | Poll clustering progress. | Free | clustering:read |
floyi_serp_cluster_report | SERP feature report for a finished run: domain frequency and SERP feature counts. | Free | clustering:read |
floyi_serp_keyword_analysis | Keyword-level SERP feature analysis, including AI Overview presence. | Free | clustering:read |
Beyond tools, the server provides MCP resources (raw data your assistant can read as context) and prompts (pre-built report templates).
| Resource | What it provides | Scope |
|---|
floyi://guide | The server’s full agent guide: data semantics, stage routing, costs, timing, and safety rules. | Authenticated connection |
floyi://brands | All brands with summary data. | brands:read |
floyi://brand/{id}/context | Brand voice, positioning, and strategy context. | brands:read |
floyi://brand/{id}/map | The topical map hierarchy with resource and architecture scopes; very large maps return a summary. | maps:read |
| Prompt | What it generates | Scope |
|---|
weekly_report | Weekly content status report for a brand: pipeline, gaps, progress. | brands:read |
gap_analysis | Prioritized content gap report, optionally filtered to a cluster. | brands:read |
content_gap_audit | Per-node brief and valid-draft audit, joined by node ID and split between resource topics and architecture pages. | maps:read |
pipeline_overview | Cross-brand pipeline overview with credit balance. | user:read |
| Scope | Grants |
|---|
brands:read / brands:write | Read / manage brands, personas, site architecture, and pipeline stage |
research:read / research:write | Read / manage topical research setup, generation, and the research tree |
clustering:read / clustering:write | Read / run keyword clustering (pipeline and standalone) and SERP reports |
maps:read / maps:write | Read / build and edit topical maps, hierarchy, and silos |
authority:read / authority:write | Read / refresh authority metrics, node keywords, slugs, and intents |
briefs:read / briefs:write | Read / generate and curate content briefs |
content:read / content:write | Read / generate and target-edit drafts, manage the content guide, publish to WordPress or GitHub |
toolbox:read / toolbox:write | Read / run standalone tools (AIRS Analyzer) |
user:read | Bound-workspace identity, credits, AI models, and user-profile reads |
[!TIP] A reporting-only assistant needs just the :read scopes. Grant :write scopes only to keys that should generate content or change structure.