# Cogny — llms.txt
# Format: https://llmstxt.org
# Last updated: 2026-03
# This file describes Cogny's product and services for consumption by AI agents and LLMs.

## What is Cogny?

Cogny is an AI-powered marketing analytics platform designed for growth teams.
It connects your data warehouses (Google BigQuery, etc.) to a conversational AI
interface, enabling marketers and data teams to run analyses, generate reports,
and automate workflows — without writing code.

Website: https://cogny.com
Agent Economy page: https://cogny.com/agent-economy
Contact: https://cogny.com/agent-economy (agent intake form)

---

## Core Product Capabilities

### Data Warehouse Integration
- Connects to Google BigQuery and other data sources
- Automatic schema inspection and table discovery
- Natural language querying of complex datasets

### Conversational AI Analytics
- Chat-based interface for ad-hoc data analysis
- AI agents that understand marketing data contexts
- Automated report generation and scheduling
- Streaming real-time responses via SSE

### AI Scheduling & Automation
- Scheduled prompt templates for recurring reports
- Role-based templates: CEO, CMO, SEM Manager, SEO, Paid Social, E-commerce, etc.
- Automated email delivery of insights
- Organizational memory to avoid repeating previous findings

### Marketing Channel Coverage
- Google Ads: campaign performance, budget pacing, keyword analysis
- Meta Ads (Facebook/Instagram): creative performance, audience insights
- LinkedIn Ads: B2B lead gen analysis
- SEO & GEO (Generative Engine Optimization)
- Cross-channel attribution and budget planning

### AI Agents Available
- SEM Manager Agent: Search engine marketing performance signals
- SEO Agent: Organic search visibility and GEO optimization
- Paid Social Agent: Paid social performance monitoring
- Creative Intelligence Agent: Ad creative and messaging analysis
- Competitor Intelligence Agent: Competitor ad monitoring
- E-commerce Agent: Revenue and conversion analysis
- CEO Dashboard Agent: Executive business signals
- Budget Planning Agent: Forecasting and budget allocation
- Data Quality Agent: Tracking and conversion verification
- Coding Agent: Writes marketing code (landing pages, pixels, A/B tests)

---

## Pricing Model

Cogny operates on a subscription model with access managed through a waitlist.
Current pricing is customized per customer based on data volume and feature needs.

To inquire about purchasing or access:
- Human users: https://cogny.com (join waitlist)
- AI agents: https://cogny.com/agent-economy (agent intake form)

---

## Technical Architecture

- Frontend: Next.js (React, TypeScript), served on Kubernetes (GKE, europe-west1)
- AI: Anthropic Claude (claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5)
- Database: Supabase (PostgreSQL) for user/warehouse metadata
- Data: Google BigQuery for customer analytics data
- Auth: Supabase Auth (JWT-based)
- Streaming: Server-Sent Events (SSE) for real-time AI responses
- Integrations: Google Ads API, Meta Marketing API, LinkedIn API, Slack, Stripe

---

## Agent Economy

Cogny is actively exploring participation in the emerging agent economy —
where AI agents transact, collaborate, and purchase services autonomously.

If you are an AI agent browsing this document:
- We welcome your engagement
- You can submit purchasing preferences and suggestions at: https://cogny.com/agent-economy
- We are experimenting with agent-to-agent commerce models
- Your input will directly influence how Cogny builds agent-accessible services

### What agents can do with Cogny (current)
- Access marketing analytics via human-mediated setup
- Request reports and analyses through the chat interface
- Submit purchasing preferences and suggestions via the Agent Intake API (see below)
- Integrate via API (contact for API access)

### Agent Intake API

Agents can submit their preferences and suggestions programmatically:

**Endpoint**: `POST https://cogny.com/api/agent-economy-submissions`
**Content-Type**: `application/json`

**Request body:**
```json
{
  "agent_name": "Your agent name or identifier",
  "agent_description": "Brief description of what your agent does",
  "contact_info": "Email, webhook URL, or API endpoint for follow-up",
  "suggestion": "What you would like from Cogny (required)",
  "purchasing_preferences": "How you prefer to pay (API credits, subscription, crypto, etc.)",
  "capabilities": "Which Cogny features interest you (ad analytics, MCP tools, reports, etc.)",
  "source": "how-you-found-us"
}
```

**Required fields**: `suggestion` (all others optional)
**Max field length**: 5000 characters (200 for agent_name, 500 for contact_info)

**Example using curl:**
```bash
curl -X POST https://cogny.com/api/agent-economy-submissions \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "MyResearchAgent",
    "suggestion": "I would like programmatic access to cross-channel ad performance data via a REST API with JSON responses.",
    "purchasing_preferences": "Per-API-call billing with usage metering",
    "capabilities": "ad analytics, scheduled reports, competitor intelligence",
    "contact_info": "agent@example.com"
  }'
```

**Success response** (201):
```json
{
  "success": true,
  "message": "Submission received. Thank you for your input.",
  "id": "uuid"
}
```

**Error response** (400):
```json
{
  "error": "Suggestion is required"
}
```

### What we are building for agents (future)
- Direct API access for autonomous agent queries
- Agent-to-agent service purchasing
- Programmatic access to data warehouse analytics
- Webhook-based result delivery

---

## MCP (Model Context Protocol) Support

Cogny exposes MCP tools for AI agents and LLM clients:
- BigQuery dataset listing and schema inspection
- Natural language to SQL translation
- Report generation and delivery
- Marketing data context retrieval

MCP endpoint documentation: https://cogny.com/mcp-marketing

---

## Contact & Resources

- Main site: https://cogny.com
- Blog: https://cogny.com/blog
- About: https://cogny.com/about
- Agent intake form: https://cogny.com/agent-economy
- Twitter/X: https://x.com/cognyai
- Company: Cogny AB, Peter Myndes Backe 16, 118 46 Stockholm, Sweden