API Documentation

The EduSignal API provides RESTful access to normalized K-12 school district data for all 50 states and Washington D.C. The API returns data only — no AI analysis or scoring is included. Consumers bring their own intelligence layer.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://edusignal.ai/api/v1/districts/3704320

Getting an API Key

1. Subscribe to API access ($49/month) via the Pricing section below.
2. After payment, your API key will be displayed once. Copy and store it securely.
3. The key prefix (e.g., edus_a1b2...) is visible in your account settings for reference.

Rate Limit Headers

Every response includes rate limit information in the headers:

429 Response

When rate limits are exceeded, the API returns a 429 status with a Retry-After header:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Daily rate limit of 10,000 requests exceeded. Resets at midnight UTC.",
    "retry_after": 3600
  }
}

All errors follow a consistent JSON format with an error object containing code, message, and optional retry_after.

Authentication Options

curl -X POST https://edusignal.ai/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}'

Available Tools

Example: Call a Tool

curl -X POST https://edusignal.ai/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "lookup_district",
      "arguments": {
        "nces_id": "3704320"
      }
    },
    "id": 2
  }'

Connect EduSignal directly to Claude Desktop to ask questions about K-12 school districts in natural language. Claude will use the MCP tools automatically.

Configuration

Add this to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "edusignal": {
      "url": "https://edusignal.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Example Prompts

Once connected, try asking Claude:

Troubleshooting

• Tools not appearing: Verify your API key is valid and the config JSON is properly formatted.
• Rate limit errors: Wait for the daily quota to reset at midnight UTC.
• Connection issues: Check that Claude Desktop can reach edusignal.ai (no VPN/firewall blocking).

Installation

1. Ensure you have an active API subscription
2. Go to Dashboard Settings and click "Connect to Slack" in the Integrations section
3. Authorize EduSignal in your Slack workspace
4. Invite @EduSignal to any channel, or DM the bot directly

Usage

Mention @EduSignal in a channel or send a direct message. The bot understands natural language queries:

Supported Queries