MCP Server

Copy page

The Spectora MCP Server lets you connect AI assistants — like Claude, ChatGPT, Cursor, and GitHub Copilot — directly to your Spectora account. The Model Context Protocol (MCP) is an open standard that gives AI tools secure, structured access to your inspection business data.

Once connected, you can use natural language to work with your data. For example:

• "Which agents referred the most inspections this quarter, and what's their contact info?"
• "Compare my top 5 agents by inspection volume over the last 6 months"
• "Find all inspections in Austin, TX from the past 30 days that are still pending"
• "Show me all clients with inspections scheduled this week"

---

Before You Begin

To set up the MCP Server, you will need:

1. A Spectora account with company admin permission.
2. An API key — you can create one here.
3. An AI tool that supports MCP — see below for setup guides covering popular tools.

---

MCP Connection Details

Use the following details to configure your AI tool:

Server URL: https://connect.spectora.com/mcp

Transport: Streamable HTTP

Authentication is supported via two methods:

Method	Format
Authorization header	Authorization: Bearer YOUR_API_KEY
Query parameter	apiKey=YOUR_API_KEY

Most tools use the header method. The query parameter method is available for tools that do not support custom headers (e.g., ChatGPT).

---

Setup Instructions

Claude Desktop

1. Go to Settings -> Developer -> Edit Config
2. Open the claude_desktop_config.json file and paste the following configuration:

macOS / Linux:

Code
{
  "mcpServers": {
    "spectora": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://connect.spectora.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Windows:

Code
{
  "mcpServers": {
    "spectora": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://connect.spectora.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

3. Save the file and restart Claude Desktop
4. Verify that spectora appears as a connected MCP server

---

ChatGPT

1. Go to Settings -> Apps -> Advanced settings and enable Developer mode
2. Click Create app and configure:
   • Name: Spectora
   • MCP Server URL: https://connect.spectora.com/mcp?apiKey=YOUR_API_KEY
   • Authentication: No Auth
3. Enable the confirmation checkbox and click Create

---

Claude Code

Run the following command in your terminal:

Code
claude mcp add --transport http spectora https://connect.spectora.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Use the /mcp command inside Claude Code to verify the connection.

---

Cursor

1. Go to Cursor Settings -> Tools & MCP -> New MCP Server
2. Paste the following configuration:

macOS / Linux:

Code
{
  "mcpServers": {
    "spectora": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://connect.spectora.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Windows:

Code
{
  "mcpServers": {
    "spectora": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://connect.spectora.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

3. Save the file and verify that spectora appears as a connected MCP server in the Installed MCP Servers panel.

---

Other

MCP is an open protocol supported by many clients. Refer to your client's documentation for specific connection steps, using the MCP Connection Details above.

Most clients accept a configuration similar to this:

Code
{
  "spectora": {
    "url": "https://connect.spectora.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

---

Available Tools

The MCP Server exposes the following tools:

Resource	Tool	Description	API
Agents	list-connections-v2	Browse and filter your agents	List Agents
Agents	get-connection-v2	Get details of a specific agent	Get Agent
Agent Stats	list-connection-stats-v2	Browse agents enriched with inspection statistics	List Agent Stats
Clients	list-contacts-v2	Browse and filter your clients	List Clients
Clients	get-contact-v2	Get details of a specific client	Get Client
Inspection Attachments	list-inspection-attachments-v2	Browse and filter inspection attachments	List Inspection Attachments
Inspections	list-inspections-v2	Browse and filter your inspections	List Inspections
Inspections	show-inspection-v2	Get details of a specific inspection	Get Inspection

---

Troubleshooting

• npx command not found — Install Node.js, which includes npx
• Authentication errors — Verify your API key is valid and has not expired. You can manage your keys here.
• Tools not appearing — Restart your AI tool after making configuration changes