Developer Documentation

Integrate AI Visibility Tools
Into Your Workflow

Sigma Score scanning, content planning, schema recommendations, and local visibility audits — available via REST API, MCP Server, A2A Protocol, and machine-readable Agent Card. No API key required.

View Tools Integration Protocols Agent Card

Available Tools

Five tools available via MCP, A2A, and REST API. All currently free with no authentication required.

sigma_score

Sigma Score AI Readiness Scan

Scans websites for SEO, Local SEO, AEO, GEO, schema, AI crawlability, and technical visibility signals. Returns a score out of 100 with per-category breakdowns.

seoaeogeoai-visibilitywebsite-audit

content_refresh_plan

Content Refresh Planner

Analyzes a website and creates a 30-day SEO, AEO, and AI visibility content plan with prioritized recommendations.

contentseoaeoplanning

schema_recommendations

Schema Recommendations

Audits a website and recommends LocalBusiness, Service, FAQ, Article, Breadcrumb, and Organization schema improvements.

schemaseostructured-data

local_visibility_audit

Local Visibility Audit

Evaluates local search presence and Google Business Profile optimization opportunities for any business.

local-seogoogle-business-profilevisibility

sigma_site_agent

Sigma Site Agent

Agent-powered website optimization, content automation, schema management, and AI visibility maintenance.

agentautomationmcpwebsite-management

Integration Protocols

Multiple ways to integrate Sigma Agents tools into your systems.

REST API

Primary

Primary integration method. JSON request/response, no authentication required. Full documentation at /api/docs.

View Docs

MCP Server

AI Native

Model Context Protocol for Claude, ChatGPT, and custom AI assistants. Expose AI visibility tools natively in any MCP-compatible client.

POST https://sigmaagents.ai/api/mcp

A2A Protocol

Agent Economy

Google Agent-to-Agent protocol for direct machine-to-machine task delegation. Submit scan tasks via JSON-RPC 2.0.

POST https://sigmaagents.ai/api/a2a

Agent Card

Discovery

Machine-readable capability discovery at .well-known/agent-card.json. Describes skills, tools, MCP server, and contact information for AI agent discovery.

View Agent Card

Code Examples

cURL— Sigma Score Scan

curl -X POST "https://sigmaagents.ai/api/v1/score" \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

# Response
{
  "domain": "example.com",
  "overall_score": 62,
  "grade": "C",
  "seo_score": 71,
  "local_seo_score": 54,
  "aeo_score": 48,
  "checks": {
    "has_meta_title": true,
    "has_schema_markup": false,
    "has_llms_txt": false,
    "ai_crawlers_allowed": true
  }
}

MCP— Tool Call via JSON-RPC 2.0

curl -X POST "https://sigmaagents.ai/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "sigma_score",
      "arguments": { "url": "example.com" }
    },
    "id": 1
  }'

# Response
{
  "jsonrpc": "2.0",
  "result": {
    "content": [{
      "type": "text",
      "text": "Sigma Score for example.com: 62/100 (Grade: C)..."
    }]
  },
  "id": 1
}

A2A— Agent-to-Agent Task

curl -X POST "https://sigmaagents.ai/api/a2a" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tasks/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{
          "type": "text",
          "text": "Scan example.com for AI readiness"
        }]
      }
    },
    "id": 1
  }'

# Response
{
  "jsonrpc": "2.0",
  "result": {
    "id": "task_abc123",
    "status": { "state": "completed" },
    "artifacts": [{
      "parts": [{
        "type": "text",
        "text": "Sigma Score: 62/100..."
      }]
    }]
  },
  "id": 1
}

Node.js— Sigma Score Lookup

const response = await fetch(
  "https://sigmaagents.ai/api/v1/score",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ url: "example.com" }),
  }
);

const { overall_score, grade, seo_score, aeo_score } =
  await response.json();

console.log(`Score: ${overall_score}/100 (Grade: ${grade})`);
console.log(`SEO: ${seo_score} | AEO: ${aeo_score}`);