# GearDex API + MCP

Source: https://www.geardex.app/api-docs

API access requires the GearDex Studio plan and a scoped Studio API key.

Use the Studio API directly or connect through MCP for controlled, tool-based workflows across your photography operation.

[Get started](https://www.geardex.app/api-docs/getting-started) [Endpoint reference](https://www.geardex.app/api-docs/endpoints)

endpoints

35

scopes

15

requests / min

120

**Request**

```bash
curl "https://www.geardex.app/api/studio-agent/v1/gear?type=camera&limit=3" \
  -H "Authorization: Bearer gdx_live_your_key_here"
```

**200 OK**

```json
{
  "data": [
    { "brand": "Sony", "model": "A7S III" },
    { "brand": "Canon", "model": "R5 C" }
  ],
  "pagination": {
    "limit": 3, "returned": 2, "total": 8
  }
}
```

## Overview

GearDex gives Studio integrations scoped access to photography inventory, shoot plans, maintenance records, documents, analytics, and profile data. Trusted services can also create and update gear, shoots, and maintenance work when their key includes write access.

Use direct HTTP calls when you control the client. Use the [MCP adapter](https://www.geardex.app/api-docs/mcp-adapter) when an agent host should work through named tools instead of composing raw requests.

Base URL

`https://www.geardex.app/api/studio-agent/v1`

## Choose a path

Start with the workflow closest to what you are building.

[Make an authenticated requestCreate a scoped Studio key and retrieve your first gear records.](https://www.geardex.app/api-docs/getting-started) [Explore the endpoint referenceWork with gear, shoots, maintenance, documents, analytics, and profile data.](https://www.geardex.app/api-docs/endpoints) [Connect through MCPExpose controlled GearDex tools to compatible agent hosts and automations.](https://www.geardex.app/api-docs/mcp-adapter) [React to studio changesVerify signed webhook events and synchronize downstream workflows.](https://www.geardex.app/api-docs/webhooks)

## Core resources

The v1 surface follows the main parts of a GearDex studio workspace.

**GearDex Studio API resources**

| Resource | Access | Covers |
| --- | --- | --- |
| `Gear` | `read + write` | Inventory records for cameras, lenses, accessories, filters, and drones. |
| `Shoots` | `read + write` | Production plans, dates, locations, status, notes, and completion progress. |
| `Maintenance` | `read + write` | Service schedules, repair status, providers, cost, and owned gear references. |
| `Documents` | `read` | Receipt, warranty, insurance, and manual metadata with timeline filters. |
| `Analytics` | `read` | Portfolio-level inventory and operational summary counts. |
| `Profile` | `read` | Account and Studio profile metadata for connected workflows. |

## Reference

- [AuthenticationBearer keys and request authentication.](https://www.geardex.app/api-docs/authentication)
- [ScopesRead and write permissions for Studio keys.](https://www.geardex.app/api-docs/scopes)
- [EndpointsGear, shoots, maintenance, documents, and analytics.](https://www.geardex.app/api-docs/endpoints)
- [Responses and errorsStatus codes, error bodies, and safe retries.](https://www.geardex.app/api-docs/errors)
- [Rate limitsRequest windows, throttling, and backoff.](https://www.geardex.app/api-docs/rate-limits)
- [WebhooksSigned event delivery and verification.](https://www.geardex.app/api-docs/webhooks)
- [OpenAPI specMachine-readable schemas for SDKs and tools.](https://www.geardex.app/api-docs/openapi)
- [Audit activityKey management and API request history.](https://www.geardex.app/api-docs/audit-logs)

## What you can build

Dashboards, assistants, reporting, and trusted planning automations. A few starting points:

Pre-shoot readiness assistant

Compare upcoming shoots with available gear and flag incomplete prep before call time.

Weekly inventory digest

Summarize gear by type, identify aging equipment, and send a focused Monday review.

Client-facing gear lists

Turn filtered inventory queries into clean equipment summaries for pitches and pre-production.

Shoot pipeline board

Build an external status view from planning, confirmed, completed, and cancelled shoots.

Warranty watchdog

Monitor document warranty metadata and trigger reminders before coverage expires.

 [See all ideas with sample payloads](https://www.geardex.app/api-docs/what-can-you-build)