Available MCP Tools

The Rampify MCP server provides several tools that bring SEO intelligence directly into your coding workflow.

get_page_seo()

Get comprehensive SEO data and insights for a specific page. Works with both production sites AND local dev servers!

Usage

get_page_seo({
  domain: "example.com",
  url_path: "/blog/post"
})

Parameters

• domain (optional) - Site domain (e.g., "example.com" or "localhost:3000"). Uses SEO_CLIENT_DOMAIN env var if not provided.
• url_path (optional) - Page URL path (e.g., "/blog/post")
• file_path (optional) - Local file path (will be resolved to URL)
• content (optional) - Current file content

Returns

{
  "source": "production_database",
  "fetched_from": "https://example.com/blog/post",
  "url": "https://example.com/blog/post",
  "performance": {
    "clicks": 1234,
    "impressions": 45678,
    "ctr": 2.7,
    "position": 8.5
  },
  "top_keywords": [
    {
      "query": "seo tools",
      "clicks": 234,
      "impressions": 8900,
      "position": 6.2
    }
  ],
  "issues": [
    {
      "type": "title_length_suboptimal",
      "severity": "warning",
      "message": "Title is only 35 characters (recommended: 50-60)"
    }
  ],
  "ai_summary": "This page is performing well but could improve its title..."
}

Example

What's the SEO status of this page?
Check SEO for /blog/post
Audit the local version of this page (localhost:3000)

---

get_issues()

Get SEO issues for entire site with health score. Returns a comprehensive report of all detected problems.

Usage

get_issues({
  domain: "example.com",
  filters: {
    severity: ["critical"],
    limit: 50
  }
})

Parameters

• domain (optional) - Site domain (uses SEO_CLIENT_DOMAIN if not provided)
• filters (optional):
  • severity: Array of severity levels (['critical', 'warning', 'info'])
  • issue_types: Array of specific issue types
  • limit: Max issues to return (1-100, default: 50)

Returns

{
  "health_score": 78,
  "grade": "B",
  "summary": {
    "critical": 3,
    "warning": 12,
    "info": 5
  },
  "issues": [
    {
      "type": "http_404",
      "severity": "critical",
      "url": "https://example.com/missing-page",
      "title": "Page not found",
      "fix": "Fix broken link or create missing page"
    }
  ],
  "recommendations": [
    "Fix 3 critical issues first (404 errors)",
    "Add missing meta descriptions to 12 pages"
  ]
}

Example

What SEO issues does my site have?
Show me only critical SEO issues
Check SEO issues for example.com

---

crawl_site()

Trigger a fresh site crawl and analysis. This actively fetches and analyzes all pages.

Usage

crawl_site({
  domain: "example.com"
})

Parameters

• domain (optional) - Site domain (uses SEO_CLIENT_DOMAIN if not provided)

Returns

{
  "status": "completed",
  "total_urls": 156,
  "urls_checked": 156,
  "issues_detected": 15,
  "duration_ms": 45000,
  "crawl_method": "sitemap"
}

Example

Crawl my site after deploying changes
Analyze example.com
Refresh SEO data for my site

---

generate_schema()

Auto-generate structured data (schema.org JSON-LD) for any page. Detects page type and generates appropriate schema with validation.

Usage

generate_schema({
  domain: "example.com",
  url_path: "/blog/post",
  schema_type: "auto"
})

Parameters

• domain (optional) - Site domain (uses SEO_CLIENT_DOMAIN if not provided)
• url_path (required) - Page URL path (e.g., "/blog/post")
• schema_type (optional) - Specific schema type or "auto" to detect (default: "auto")

Supported schema types:

• Article / BlogPosting - Blog posts, articles, news
• Product - Product pages, e-commerce
• Organization - About pages, company info
• FAQPage - FAQ pages with Q&A
• BreadcrumbList - Auto-added for navigation

Returns

{
  "detected_page_type": "Article",
  "recommended_schemas": ["Article", "BreadcrumbList"],
  "schemas": [
    {
      "type": "Article",
      "json_ld": {
        "@context": "https://schema.org",
        "@type": "Article",
        "headline": "Your article title",
        "author": { "@type": "Person", "name": "Author Name" }
      },
      "validation": {
        "valid": false,
        "warnings": ["Replace placeholder values with actual data"]
      }
    }
  ],
  "implementation": {
    "where_to_add": "In your page component's metadata",
    "code_snippet": "// Next.js code here",
    "instructions": "1. Add code to page.tsx..."
  }
}

Example

Generate schema for /blog/indexnow-faster-indexing
Generate Product schema for /products/widget
Add structured data to this page

---

generate_meta()

Generate optimized meta tags (title, description, Open Graph tags) for a page. Uses your client profile for personalized recommendations.

Usage

generate_meta({
  domain: "example.com",
  url_path: "/blog/post",
  include_og_tags: true,
  framework: "nextjs"
})

Parameters

• domain (optional) - Site domain (uses SEO_CLIENT_DOMAIN if not provided)
• url_path (required) - Page URL path (e.g., "/blog" or "/blog/post")
• include_og_tags (optional) - Include Open Graph tags for social sharing (default: true)
• framework (optional) - Framework format - nextjs, html, astro, or remix (default: "nextjs")

Returns

{
  "page_analysis": {
    "current_title": "SEO Tips",
    "current_description": "Tips for SEO",
    "page_type": "blog_post",
    "word_count": 1500,
    "key_topics": ["seo", "optimization", "rankings"]
  },
  "issues": [
    "Title too short (only 8 characters, recommended: 50-60)"
  ],
  "profile_warnings": [
    "⚠️ Target audience not set - add this for better results"
  ]
}

The AI then uses this analysis to generate optimized meta tags based on your business profile.

Example

Generate better meta tags for /blog
Fix the title too short issue on /blog/post
Create HTML meta tags for /products/widget

---

Tool Availability

All tools are currently available to all users:

Next Steps

• View full API reference
• Learn about configuration
• Explore the dashboard