API Reference

Complete reference for the Cultural Intelligence API V1. All endpoints require authentication via Bearer token.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer mcp_your_api_key_here

Get your API key by registering at POST /api/api-keys/register or visit the Getting Started page.

Endpoints

POST/api/v1/query

Query Cultural Context

Query the cultural intelligence knowledge base for information about business norms, etiquette, and cultural practices.

1 credit

Request Parameters

query

stringrequired

Cultural question (max 500 chars)

target_markets

string[]

ISO 3166-1 alpha-2 country codes

industry

string

Industry context (IT, Healthcare, Retail, etc.)

use_vector_search

boolean

Use semantic vector search (default: true)

Example Request

curl -X POST "https://api.kultur.dev/api/v1/query" \
  -H "Authorization: Bearer mcp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "What are business gift-giving customs in Japan?",
  "target_markets": [
    "JP"
  ],
  "industry": "Retail"
}'

Example Response

{
  "request_id": "uuid",
  "query": "string",
  "response": "string (cultural context)",
  "confidence_score": 0.85,
  "sources_used": [
    "knowledge_base_v2"
  ],
  "regions_covered": [
    "Japan"
  ],
  "processing_time_ms": 1234.5,
  "credits_used": 1,
  "credits_remaining": 14999
}

Try It

API Key