API & MCP Guide

{
  "mcpServers": {
    "dagenoai-llm-data": {
      "url": "https://api.dageno.ai/llm-data-mcp/mcp",
      "headers": { "Authorization": "Bearer API_KEY" }
    }
  }
}

type Result<T> = { data: T; meta: Meta };
type Meta = {
  requestId: string; generatedAt: string;
  hasMore?: boolean; nextCursor?: string | null;
  truncated?: boolean; limit?: number; maxRecords?: number;
  timezone?: string;
  requestedRange?: { startDate: string; endDate: string };
  effectiveRange?: { startDate: string; endDate: string } | null;
  validDays?: number; dataAsOf?: string | null;
  population?: string; aggregation?: string;
  aggregations?: Record<string, string>;
  metricVersion?: string; scopeVersion?: string; quality?: string;
  sample?: { mode: string; size: number | null; limit: number | null };
  syncLookbackDays?: number;
  segmentSelection?: string;
};
type NamedCode = { code: string; name: string };
type Market = { categoryId: string; name: string };
type TrackingBrand = { domain: string; name: string; isOwn: boolean };
type MarketBrand = { entityId: string; name: string; isOwn: boolean; isConfigured: boolean };
type Budget = { used: number; limit: number; remaining: number; resetAt: string };
type Project = {
  projectId: string; name: string; brand: { name: string; domain: string };
  modules: { tracking: boolean; market: boolean }; capabilities: string[];
};
type ProjectDetail = Project & {
  tracking: { brands: TrackingBrand[]; platforms: NamedCode[]; regions: NamedCode[];
    timezone: string; dataAsOf: string | null } | null;
  market: { ownBrand: MarketBrand; competitors: MarketBrand[]; categories: Market[];
    platforms: NamedCode[]; regions: NamedCode[]; timezone: string; dataAsOf: string | null } | null;
  limits: Record<string, number>;
  budgets: { evidenceDaily: Budget; requestsDaily: Budget };
};
type Topic = { topicId: string; name: string; promptCount: number };
type Prompt = {
  promptId: string; text: string; topicId: string | null;
  platforms: string[]; regions: string[]; status: 'active' | 'paused';
  collectionStatus: string; createdAt: string;
};

type MetricRow<T> = { dimensions: Record<string, unknown>; metrics: T };
type TrackingMetrics = {
  visibility: number | null; aiMention: number | null; shareOfVoice: number | null;
  avgPosition: number | null; ownDomainCitationRate: number | null;
  responseCount: number; mentionResponseCount: number; visibleResponseCount: number;
  citedResponseCount: number; ownDomainCitedResponseCount: number;
  mentionCount: number; comparisonMentionCount: number; validDays: number;
};
type MarketMetrics = {
  visibility: number | null; mentionResponseCount: number; responseCount: number;
  avgPosition: number | null; rankedResponseCount: number; validDays: number;
};
type Citation = {
  domain: string; url: string | null; title: string | null; domainType: string;
  citedResponseCount: number; citationCount: number; citationRate: number | null;
  denominator: { kind: string; count: number };
};
type TrackingResponse = {
  responseId: string; promptId: string; promptText: string; topicId: string | null;
  platform: string; region: string; date: string; respondedAt: string; collectedAt: string;
  ownBrand: { mentioned: boolean; visible: boolean; position: number | null };
  answerMarkdown: string; citations: { url: string; domain: string }[];
};
type MarketResponse = {
  responseId: string; question: string | null; platform: string; region: string; date: string;
  excerpt: string; citationUrls: string[];
  mentionedBrands: { brand: MarketBrand; position: number | null }[];
};
type MarketScope = {
  authorized: Market[];
  ownBrandSegments: (Market & { authorized: boolean; visibility: number | null;
    mentionResponseCount: number; responseCount: number; rank: number | null })[];
};

type EntityRef = { entityId: string; name: string; type: string; detailAccessible: boolean };
type EntityDetail = {
  entity: EntityRef; displayAlias: string | null; domain: string | null;
  parent: EntityRef | null; childCount: number;
  metrics: { directResponseCount: number; rollupResponseCount: number; totalResponseCount: number;
    visibility: number | null; top1Rate: number | null; avgPosition: number | null;
    rankedResponseCount: number };
};
type Relation = { entity: EntityRef; relationType: 'child'; responseCount: number;
  shareOfParent: number | null; avgPosition: number | null };
type CoMention = { entity: EntityRef; coMentionResponseCount: number; coMentionIndex: null };
type EntitySource = { domain: string; url: string | null; citedResponseCount: number;
  citationRate: number | null; denominator: { kind: string; count: number } };

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid endDate",
    "requestId": "44444444-4444-4444-8444-444444444444",
    "details": [{ "field": "endDate", "reason": "out_of_range" }]
  }
}