Skip to main content

AI agents and MCP

Your AI agent does the SEO work with real data and firm limits.

Connect Claude, Codex, Cursor or VS Code to Crawl Foundry. Your agent reads saved evidence, researches keywords and competitors, checks site health, builds plans and drafts content, always in one workspace and within your budget and approvals.

Start freeSet up the MCP server
Your AI agentCrawl Foundry MCP
Example session

Find the three best keyword opportunities for this workspace. Use saved data first and stay within my agent budget.

  1. seo_get_workspace_overviewConfirms the workspace, balance and limitssaved data · free
  2. seo_research_keywordsReads saved keyword evidence and fetches fresh data only where it is missingfresh data €0.10
  3. seo_find_opportunitiesRanks opportunities by demand, difficulty and fitsaved data · free
  4. seo_build_seo_planTurns the top three into a plan you can keep working onsaved data · free

Three opportunities, each with its evidence and a next step.

Top opportunities

  • email marketing tools
  • crm software pricing
  • best trail running shoes
Agent budget for this workspace€0.10 of €10.00 this month

Two ways in

One engine for your agent and your own software.

AI agents connect through the SEO MCP server. Your own tools and automations use the SEO REST API. Both reach the same workspace, the same EUR balance and the same limits.

For AI agents

SEO MCP server

Your agent signs in with OAuth and picks the right tools on its own.

Claude Code, in one line

claude mcp add --transport http --scope user crawl_foundry "https://app.crawlfoundry.com/api/mcp"

https://app.crawlfoundry.com/api/mcp

  • Claude
  • Codex
  • Cursor
  • VS Code
Set up the MCP server

Your workspace

  • Same data
  • Same EUR balance
  • Same limits

For your own software

SEO REST API

Versioned operations with an OpenAPI description and API keys that organization admins create and revoke.

  1. Get the pricePOST/api/v1/workspaces/{id}/action-quotes
  2. Approve itPOST/api/v1/workspaces/{id}/action-quotes/{quoteId}/approvals
  3. Run itPOST/api/v1/workspaces/{id}/action-executions
  4. Follow the resultGET/api/v1/workspaces/{id}/operations/{operationId}

API documentationOpenAPI description

What your agent can do

Five kinds of SEO work in one workspace

Each task is a defined agent tool with known permissions and a known cost class, so you always know what the agent may do.

25 agent tools

  • Free
  • Saved free, fresh pay per use
  • Pay per use
  • Approval only

  1. Understand the workspace and costs

    Read workspace context, connected sources, balance, limits and running operations.

    • seo_get_workspace_overviewFree
    • seo_get_account_statusFree

  2. Research and analyze

    Keywords, domains, competitors, rankings, site health, backlinks, search performance and AI visibility.

    • seo_research_keywordsSaved free, fresh pay per use
    • seo_analyze_domainSaved free, fresh pay per use
    • seo_analyze_competitorsSaved free, fresh pay per use
    • seo_analyze_search_performanceSaved free, fresh pay per use
    • seo_analyze_rankingsFree
    • seo_analyze_siteSaved free, fresh pay per use
    • seo_analyze_backlinksSaved free, fresh pay per use
    • seo_analyze_ai_visibilitySaved free, fresh pay per use

  3. Plan and organize

    Turn evidence into opportunities, SEO plans, organized keyword lists and tasks that last beyond one chat.

    • seo_find_opportunitiesFree
    • seo_build_seo_planFree
    • seo_organize_keywordsFree
    • seo_manage_workFree

  4. Execute with safeguards

    Manage rank tracking and Site Audit, create and improve content, add internal links, and publish only after explicit approval.

    • seo_manage_trackingSaved free, fresh pay per use
    • seo_manage_site_auditFree
    • seo_create_contentSaved free, fresh pay per use
    • seo_score_contentSaved free, fresh pay per use
    • seo_generate_metadataPay per use
    • seo_insert_linksSaved free, fresh pay per use
    • seo_optimize_contentSaved free, fresh pay per use
    • seo_publish_contentApproval only

  5. Monitor and verify

    Follow long-running work and measure whether a change had the effect you expected.

    • seo_get_operationFree
    • seo_cancel_operationFree
    • seo_verify_resultsFree

The MCP server page shows how to connect your tool in a few minutes. When the agent finds opportunities, your team prioritizes the work in the Action Center.

Firm limits

Your agent works for you, not around you

Agent requestseo_research_keywordsFresh data for 324 keywords€0.10

  • Saved data is free to read

    Reading stored evidence costs nothing. Fresh data and generation use the same EUR balance as the app, with no separate API subscription.

  • Evidence instead of guesses

    Answers come from your workspace data and fresh measurements, with data gaps named, so the agent does not have to invent search volumes.

  1. One workspace per session

    The agent selects exactly one workspace and confirms it before it starts. Data from different clients never mixes.

    passed

  2. Access you can revoke

    Extra permissions are granted once, for one task, for a set time or until revoked, and you can withdraw them at any time.

    passed

  3. A budget with hard ceilings

    Set a monthly limit for the organization, a budget per workspace and a maximum per action. Crawl Foundry reserves at most the quoted price and releases the rest.

    • €5per action
    • €10per workspace and month
    • €50per organization and month

    Every new connection starts with this budget. Change it or switch it off in the Agent Platform.

    passed

  4. Protected actions stay protected

    No budget unlocks publishing or changes to deployments, DNS, users or billing. Publishing always needs your explicit approval.

    seo_publish_content
    Needs your approval

Ready-made workflows

Start from a proven workflow

MCP clients that support prompts list these workflows. Each one guides the agent through the right tools in the right order.

  1. Diagnose the SEO workspace

    Check sources, freshness and gaps, then name the most useful next steps.

    MCP promptseo_workspace_diagnosis

    1. get_workspace_overview
    2. get_account_status
    3. find_opportunities
    4. build_seo_plan

  2. Build a keyword growth plan

    From research to organized keyword lists and a verified ranking baseline.

    MCP promptseo_keyword_growth

    1. get_workspace_overview
    2. research_keywords
    3. find_opportunities
    4. organize_keywords
    5. manage_tracking

  3. Triage technical SEO health

    Sort Site Audit findings by impact and plan the fixes.

    MCP promptseo_technical_health

    1. get_workspace_overview
    2. analyze_site
    3. manage_site_audit
    4. build_seo_plan
    5. verify_results

  4. Create evidence-backed content

    Brief, outline and draft content grounded in your workspace evidence.

    MCP promptseo_content_growth

    1. get_workspace_overview
    2. research_keywords
    3. create_content
    4. score_content
    5. insert_links

  5. Run a full SEO growth cycle

    Research, plan, execute and verify in one guided run.

    MCP promptseo_full_growth_cycle

    1. get_workspace_overview
    2. research_keywords
    3. find_opportunities
    4. create_content
    5. publish_content
    6. verify_results

Results you can see

Interactive views right in the chat

In clients that display MCP Apps, results open as interactive views instead of plain text.

In your chat

  • Rank tracking trend
  • Keyword opportunity matrix
  • Site Audit health
  • Search performance
  • AI visibility and citations

Questions about AI agents

Which AI agents can I connect?

Crawl Foundry offers guided setup for Claude, Codex, Cursor and VS Code. Any other MCP client that supports Streamable HTTP connects with the MCP address.

Can the agent buy data on its own?

By default, yes: within a starting budget of €5.00 per action, €10.00 per workspace and €50.00 per organization each month. You can change that budget or switch it off. Reading saved data stays free.

Can the agent publish content?

Only after your explicit approval. Publishing is a protected action that no budget unlocks.

What does it cost?

Connecting is free on every plan. Saved reads cost nothing; fresh data and generation use your EUR balance, which you can top up once from €9.99. There is no separate API subscription.

Can my agent see another client's data?

No. Each session is bound to exactly one workspace that the agent must confirm, and access follows the permissions of that workspace.

Give your agent real SEO data.

Start free with 3 workspaces and €1.00 of balance a month, then connect your agent in a few minutes.

Start freeSet up the MCP server

Keep going

Where to look next

The next useful pages from here, each with what you get there.

  1. FeatureSEO MCP Server for Claude, Codex and CursorConnect your AI agent to Crawl Foundry over MCP with OAuth sign-in. Saved SEO data is free to read; fresh data uses your EUR balance./features/seo-mcp-server
  2. FeatureAction CenterBring crawl and keyword evidence into one prioritized queue of work worth doing next./features/action-center
  3. OverviewAll featuresThe full set, from keyword discovery through site audit to the action center./features

Cookie policyPrivacy policy