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 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 for compatibility and deprecation details.
Core Capabilities
Structured Search
Use keyword, entity, country, date, and pagination parameters for precise record retrieval.
GET /v1/icd/videosGET /v1/icd/imagesGET /v1/icdb/videosGET /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-searchGET /v1/icdb/nl-search
Domain GenAI
Ask independent questions or continue a credential-bound conversation.
POST /v1/icd/domain-genaiPOST /v1/icdb/domain-genaiDELETE /v1/{dataset}/domain-genai/conversations/{conversation_id}
Geo Manifests
Retrieve authorized, mappable records using cursor-based traversal.
GET /v1/{dataset}/videos/geo-manifestGET /v1/{dataset}/images/geo-manifest
MCP
Connect compatible assistants and agent clients, including ChatGPT, using the MCP endpoints:
POST /mcp-icdPOST /mcp-all
MCP tools honor the same API-key permissions as their REST equivalents.
Base URL
Code
All requests must use HTTPS and a valid Bearer token.
Recommended Path
- Follow the Quickstart.
- Read Choosing the Right Endpoint.
- Review Access and Permissions.
- Use the interactive API Reference for exact parameters and schemas.
- Check Limitations and the Changelog before production deployment.
