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-21 (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 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. | 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 |