SpeedThings Documentation

Welcome to SpeedThings! This documentation will help you get the most out of our performance optimization platform and MCP agents.

What are MCP Agents?

Model Context Protocol (MCP) agents are AI-powered tools that connect SpeedThings to external services and APIs. They enable seamless automation of your performance optimization workflows by integrating with thousands of applications and services.

Professional Plan

4 premium agents for growing businesses

  • Zapier Integration
  • Database Optimizer
  • Website Monitoring
  • SEO Intelligence

Business Plan

8 total agents including enterprise features

  • All Professional agents
  • Azure Cloud Suite
  • API Performance Monitor
  • Custom API Builder
  • Multi-Database Analytics

Free Tools

SpeedThings offers a comprehensive suite of free tools available to all registered users. These tools provide essential functionality for web optimization and development workflows.

AI Assistant

Free

Get instant performance optimization help and recommendations from our AI-powered assistant.

Features:
  • Performance optimization tips
  • Code review and suggestions
  • Best practices guidance
  • Troubleshooting support
API Endpoint:
POST /api/tools/ai-chat

Requires authentication

SEO Quick Check

Free

Instant SEO analysis for any website with actionable recommendations.

Usage Example:
curl -X POST "https://speedthings.com/api/tools/seo-quick-check" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com"
  }'

CSS Gradient Generator

Free

Create beautiful CSS gradients with an intuitive visual interface.

Features:
  • Linear gradients
  • Radial gradients
  • Multiple color stops
  • CSS code export

Meta Tag Generator

Free

Generate SEO-optimized meta tags for better search engine visibility.

Generated Tags:
  • Title and description
  • Open Graph tags
  • Twitter Card tags
  • Schema markup
SEO Benefits:
  • Better search rankings
  • Improved click-through rates
  • Social media optimization
  • Rich snippets support

Color Palette Generator

Free

Generate harmonious color schemes for your web design projects.

Color Theory Support:
  • Complementary
  • Analogous
  • Triadic
  • Monochromatic

AI Prompts Library

Free

Download our curated collection of 100+ proven AI prompts for web development and optimization.

Categories Include:
  • Code optimization
  • Performance analysis
  • SEO content
  • Debugging assistance

Core Performance Tools

Professional-grade performance optimization tools available to all verified users. These tools form the core of the SpeedThings platform and provide comprehensive website analysis.

Website Speed Analyzer

Core Tool

Comprehensive website performance analysis with Core Web Vitals, Lighthouse metrics, and actionable optimization recommendations.

Metrics Analyzed:
  • Page Load Time
  • First Contentful Paint (FCP)
  • Largest Contentful Paint (LCP)
  • First Input Delay (FID)
  • Cumulative Layout Shift (CLS)
API Usage:
POST /api/tools/website-speed-test
{
  "url": "https://example.com",
  "device": "desktop|mobile",
  "location": "us-east|eu-west"
}
Sample Response:
{
  "score": 87,
  "loadTime": 2.34,
  "pageSize": "2.1MB",
  "recommendations": [
    "Optimize images for better compression",
    "Enable text compression",
    "Eliminate render-blocking resources"
  ]
}

Image Optimizer

Core Tool

Compress and optimize images automatically. Supports WebP conversion, quality adjustment, and bulk optimization.

Supported Formats:
  • JPEG, PNG, GIF
  • WebP conversion
  • SVG optimization
  • Lossless compression
Optimization Features:
  • Smart compression algorithms
  • Auto-resize for web
  • Color optimization
  • Size reduction up to 80%
API Endpoint:
POST /api/tools/optimize-image
Content-Type: multipart/form-data

Form fields:
- image: File upload
- quality: 0-100 (optional, default: 80)
- format: webp|jpeg|png (optional)

Code Minifier

Core Tool

Minify CSS, JavaScript, and HTML. Remove whitespace, optimize code structure, and reduce file sizes for faster loading.

CSS

Remove comments, whitespace, and optimize selectors

JavaScript

Variable renaming, dead code elimination

HTML

Remove unnecessary tags and attributes

Typical Savings:
20-40%

CSS files

30-50%

JavaScript files

10-25%

HTML files

SEO Speed Checker

Core Tool

Analyze how page speed affects SEO rankings. Get Google PageSpeed insights and mobile optimization recommendations.

API Usage:
POST /api/tools/seo-check
{
  "url": "https://example.com",
  "includeKeywords": true,
  "mobileAnalysis": true
}

CDN Analyzer

Core Tool

Test CDN performance, analyze global load times, and optimize content delivery for worldwide audiences.

Global Test Locations:
  • North America (US, Canada)
  • Europe (UK, Germany, France)
  • Asia Pacific (Japan, Singapore)
  • South America (Brazil)

Performance Monitor

Core Tool

Continuous performance monitoring with alerts, historical data, and automated optimization suggestions.

Monitoring Features:
  • Real-time monitoring
  • Performance trends
  • Custom alerts
  • Historical data
API Endpoints:
POST /api/tools/start-monitoring
GET /api/tools/monitoring-data/:domain

MCP Agents Overview

Each MCP agent provides specific functionality to enhance your optimization workflow. Agents can be enabled/disabled from your dashboard and configured to meet your specific needs.

Professional Plan Agents

Zapier Integration

Professional+

Connect SpeedThings to 7,000+ apps and 30,000+ actions for complete workflow automation.

Key Features:
  • Connect to Slack, Google Workspace, HubSpot, Salesforce
  • Automated workflow triggers based on performance metrics
  • Real-time data synchronization
  • Custom action creation and templates
Use Cases:
  • • Automatically create Slack notifications when site speed drops
  • • Sync performance data to Google Sheets for reporting
  • • Create Jira tickets for performance issues
  • • Update CRM records with optimization results

Database Optimizer

Professional+

AI-powered database performance analysis with optimization recommendations.

Supported Databases:
PostgreSQL
MySQL
Microsoft SQL Server
MariaDB
Configuration Example:
{
  "database": {
    "type": "postgresql",
    "host": "your-db-host.com",
    "port": 5432,
    "database": "your_db_name",
    "monitoring_interval": "5m",
    "alert_threshold": {
      "slow_query_time": 2000,
      "connection_limit": 80
    }
  }
}

Business Plan Agents

Business Plan Required

These advanced agents require a Business plan subscription and provide enterprise-level functionality.

Azure Cloud Suite

Business Only

Complete cloud infrastructure monitoring and management for Azure resources.

Monitoring Features:
  • Resource utilization tracking
  • Cost analysis and optimization
  • Security compliance checks
  • Performance benchmarking
Supported Services:
  • App Service
  • Azure SQL Database
  • Storage Accounts
  • Virtual Machines

Custom API Builder

Business Only

Expose your internal APIs as AI-accessible MCP tools for seamless integration.

FastAPI Integration Example:
from fastapi import FastAPI
from speedthings_mcp import FastApiMCP

app = FastAPI()
mcp = FastApiMCP(app)

@app.post("/optimize")
async def optimize_endpoint(data: dict):
    # Your optimization logic here
    return {"status": "optimized", "improvements": data}

# Automatically exposes as MCP tool
mcp.register_endpoint("/optimize", "Website Optimization")

Agent Configuration

Quick Setup

Most agents work out-of-the-box with sensible defaults. Advanced configuration is available for custom use cases.

Enabling Agents

  1. Navigate to your Dashboard
  2. Scroll to the "AI Agents & Integrations" section
  3. Click "Enable" on any agent available for your plan
  4. Configure agent settings if needed
  5. Start using the agent in your workflows

Configuration Options

Standard Configuration Format:

{
  "agent_id": "zapier-integration",
  "enabled": true,
  "configuration": {
    "api_key": "your-api-key",
    "webhook_url": "https://hooks.zapier.com/...",
    "triggers": [
      "performance_degradation",
      "optimization_complete"
    ],
    "filters": {
      "min_score_change": 10,
      "domains": ["example.com", "app.example.com"]
    }
  },
  "rate_limits": {
    "requests_per_hour": 100,
    "burst_limit": 10
  }
}

API Integration

SpeedThings provides a comprehensive REST API for managing agents programmatically. Perfect for CI/CD integration and automated workflows.

Authentication

Use session-based authentication or API keys

curl -H "Authorization: Bearer your-api-key" \
  https://speedthings.com/api/mcp/agents/available

Rate Limits

Generous limits for all plan types

  • Professional: 1,000 requests/hour
  • Business: 5,000 requests/hour

Common API Endpoints

GET /api/mcp/agents/available

List all agents available for your plan

POST /api/mcp/agents/enable

Enable an agent with configuration

GET /api/mcp/agents/{agentId}/stats

Get usage statistics for an agent

Troubleshooting

Agent Won't Enable

  • • Check that your plan includes the agent
  • • Verify your subscription is active
  • • Ensure you haven't reached the agent limit

Agent Errors

  • • Check agent configuration for typos
  • • Verify API keys and credentials
  • • Review rate limiting settings
  • • Check the agent usage logs in dashboard

Performance Optimization

  • • Use appropriate rate limits for your use case
  • • Enable only the agents you actively use
  • • Configure filters to reduce unnecessary triggers
  • • Monitor agent usage statistics regularly

Examples & Use Cases

Automated Performance Alerting

Set up automatic notifications when your website performance degrades.

Workflow:

  1. Enable Performance Monitor agent
  2. Configure Zapier Integration with Slack webhook
  3. Set performance threshold (e.g., score drops below 80)
  4. Receive instant Slack notifications with optimization suggestions

Zapier Configuration:

{
  "trigger": "performance_degradation",
  "conditions": {
    "score_threshold": 80,
    "score_drop": 10
  },
  "actions": [{
    "type": "slack_notification",
    "channel": "#alerts",
    "message": "🚨 Performance alert: {{domain}} score dropped to {{current_score}}"
  }]
}

Database Performance Monitoring

Monitor your database performance and get AI-powered optimization recommendations.

Setup Steps:

  1. Enable Database Optimizer agent
  2. Configure database connection
  3. Set monitoring intervals
  4. Review optimization suggestions

Benefits:

  • • Identify slow queries automatically
  • • Get index recommendations
  • • Monitor connection pools
  • • Prevent performance issues

Need Help?

Our support team is here to help you get the most out of SpeedThings MCP agents.