# IntelCenter API

Welcome to the **IntelCenter Developer Portal**.

The IntelCenter API provides authenticated programmatic access to ICD and ICDB data services. Integrations can search and retrieve records, discover material with natural-language queries, ask evidence-grounded Domain GenAI questions, build map experiences, and connect through the Model Context Protocol (MCP).

---

## Current Release: v1.3.1

Released September 2, 2026. See the [Changelog](/changelog) for the latest improvements and compatibility details.

---

## What's New in v1.3

- **Direct Component ID lookup** for ICD and ICDB video and image records
- **Materially improved keyword-search performance** with unchanged request and response contracts
- **Expanded MCP discovery** with accurate behavior annotations for compatible clients
- **Geo Manifest documentation** for map-oriented integrations
- **Substantially improved multi-turn Domain GenAI quality and continuity** for follow-up questions, with clear lifecycle and deletion guidance
- **Stronger edge protection and resilience** without changes to client authentication
- **More complete documentation** covering every public endpoint, limitations, and deprecations

See the [Changelog](/changelog) for compatibility and deprecation details.

---

## Core Capabilities

### Structured Search

Use keyword, entity, country, date, and pagination parameters for precise record retrieval.

- `GET /v1/icd/videos`
- `GET /v1/icd/images`
- `GET /v1/icdb/videos`
- `GET /v1/icdb/images`

### Component ID Lookup

When a Component ID is known, use the dedicated direct-lookup route rather than keyword search.

- `GET /v1/icd/videos/by-component-id/{component_id}`
- `GET /v1/icd/images/by-component-id/{component_id}`
- Equivalent ICDB routes are available with the same structure.

### Natural Language Search

Use descriptive language to retrieve ranked records.

- `GET /v1/icd/nl-search`
- `GET /v1/icdb/nl-search`

### Domain GenAI

Ask independent questions or continue a credential-bound conversation.

- `POST /v1/icd/domain-genai`
- `POST /v1/icdb/domain-genai`
- `DELETE /v1/{dataset}/domain-genai/conversations/{conversation_id}`

### Geo Manifests

Retrieve authorized, mappable records using cursor-based traversal.

- `GET /v1/{dataset}/videos/geo-manifest`
- `GET /v1/{dataset}/images/geo-manifest`

### MCP

Connect compatible assistants and agent clients, including ChatGPT, using the MCP endpoints:

- `POST /mcp-icd`
- `POST /mcp-all`

MCP tools honor the same API-key permissions as their REST equivalents.

---

## Base URL

```text
https://api.intelcenter.com
```

All requests must use HTTPS and a valid Bearer token.

---

## Recommended Path

1. Follow the [Quickstart](/quickstart).
2. Read [Choosing the Right Endpoint](/choosing-endpoint).
3. Review [Access and Permissions](/access-and-permissions).
4. Use the interactive [API Reference](/api) for exact parameters and schemas.
5. Check [Limitations](/limitations) and the [Changelog](/changelog) before production deployment.