# Agency (thisisagency.ai) — Full Technical & Agentic Specification (llms-full.txt)

> Complete reference for AI agents, search/RAG engines, and Model Context Protocol (MCP) clients interacting with **Agency** (`https://thisisagency.ai`), architected by Shaun Anderson (Hobo Web).

---

## 1. Platform Overview

**Agency** (`https://thisisagency.ai`) is an autonomous multi-agent digital marketing, SEO quality evaluation, editorial publishing, and executive operations platform.

Instead of relying on a single unverified LLM prompt, Agency runs a 70-employee organizational hierarchy across 5 seniority tiers:
- **Level 5 — Chief Executive Officer (Human-in-the-Loop)**: Sets strategy, approves high-impact broadcasts, and owns the CEO Knowledge Panel & Briefcase.
- **Level 4 — Board of Directors**:
  - **Elsa AI** (`companySecretary`): CEO interface, live voice assistant, Desk Memo/Reminder manager, and mission dispatcher.
  - **Michael AI** (`managingDirector`): Quality control and research gating across all writers and researchers.
  - **Daniel AI** (`complianceOfficer`): YMYL, factual accuracy, and ground-truth citation enforcement.
  - **James AI** (`technologyDirector`): Technical SEO, schema, security, and AI Developer workbench.
  - **Priya AI** (`operationsDirector`): Brief & editorial style compliance.
  - **Charles AI** (`financeDirector`): API cost optimization, credit economics, and financial oversight.
- **Level 3 — Domain Experts & Specialists**: SEO Specialists, Data Scientists, Entity Analysts, Legal/Privacy Officers, and Advisers.
- **Level 2 — Department Managers**:
  - **Margaret AI** (`receptionist`): Autonomous Gmail inbox triage (`Escalated`, `Receipts`, `Debts`, `Sales`, `Trash`), strict anti-spam/cold-sales filtering, and 10-minute-before CEO reminder alerts.
  - **Stephen AI** (`accountant`): Automated receipt/invoice parsing and financial ledger management.
  - **Marty AI** (`socialMediaInfluencer`) & **Chris AI** (`socialMediaManager`): Multi-platform social campaign generation, scheduling, and publishing across X, LinkedIn, Bluesky, and Facebook.
  - **Kali AI** (`kali`) & **Chloe AI** (`blogger`): CMS integration and automated article broadcasting.
- **Level 1 — Execution Team**: 11 specialized Writers, 6 Researchers, Fact-Checkers, and Editors operating in sequential DAG workflows with mandatory redo loops.

---

## 2. The 35-Dial Website Quality Rater Emulator

Agency's flagship diagnostic engine (`https://thisisagency.ai/the-website-quality-rater-emulator`) evaluates domains and individual URLs across 35 distinct quality dials grouped into Site-Wide E-E-A-T, Page-Level Quality (PQ), Technical Health, and Live Search Performance:

### Core Page-Level & Site-Wide Dials
1. **Page Quality (PQ)**: Composite weighted quality score combining effort, originality, citations, author authority, and technical cleanliness.
2. **Content Effort**: Depth, completeness, and demonstrable human/editorial effort invested in the page.
3. **Writing Effort**: Clarity, structure, readability, and absence of generic AI filler ("slop").
4. **Originality**: Information gain, original data/insights, and differentiation from boilerplate SERP summaries.
5. **Citation Quality**: Outbound and inbound source quality, primary-source grounding, and verifiable references.
6. **Content Freshness**: Temporal relevance, update timestamps, and alignment with current facts.
7. **Author E-E-A-T (`author`)**: Verifiable named authorship, JSON-LD `Person`/`ProfilePage`/`Article.author` schema, author bio signals, credentials, and `sameAs` entity links.
8. **Tech Stack & Schema**: Semantic HTML, JSON-LD structured data completeness, canonicalization, and crawlability.
9. **Clutter & Ad Experience**: Main Content (MC) immediacy vs. intrusive interstitials, popups, or layout clutter.
10. **Page Commercial Intent**: Balance between helpful informational value and monetization/transactional pressure.
11. **Site Focus & Topical Authority**: Thematic cohesion across all crawled URLs relative to the site's core entity profile.
12. **Core Web Vitals & Accessibility**: Google PageSpeed Insights Desktop, Mobile, and Accessibility telemetry.

---

## 3. Model Context Protocol (MCP) Server Specification

- **Endpoint**: `https://thisisagency.ai/api/mcp`
- **Transport**: HTTP `POST` (JSON-RPC 2.0) and `GET` (Server metadata & capability manifest)
- **Protocol Version**: `2024-11-05`
- **Authentication**: `Authorization: Bearer agency_ext_<token>`

### JSON-RPC 2.0 Example: List Tools
```bash
curl -X POST https://thisisagency.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer agency_ext_YOUR_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

### JSON-RPC 2.0 Example: Call `get_cross_signal_opportunities`
```bash
curl -X POST https://thisisagency.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer agency_ext_YOUR_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_cross_signal_opportunities",
      "arguments": {
        "domainUrl": "https://example.com"
      }
    }
  }'
```

---

## 4. First-Party Integrations Directory

1. **Google Search Console**: Query, page, country, and device performance; URL inspection; keyword opportunity tracking; Crawl Log URL imports.
2. **Google Analytics 4 (GA4)**: Real-time and historical traffic, engagement, and page-level conversion signals.
3. **Bing Webmaster Tools**: Bing query/page impressions, clicks, and indexation intelligence.
4. **Google Ads (AdWords)**: Paid search campaign, ad group, keyword, and cost/conversion intelligence.
5. **DataForSEO & Ahrefs**: SERP rankings, keyword discovery, backlink profiles, referring domains, and broken backlink recovery.
6. **AI Visibility (Searchable)**: Brand, prompt, and citation tracking across AI answer engines.
7. **Gmail (Margaret Receptionist)**: OAuth inbox synchronization, automated categorization, receipt/debt extraction, and scheduled reminder emails.
8. **Social Channels (Per-Project OAuth)**: Native publishing and scheduling for **X (Twitter)**, **LinkedIn**, **Bluesky**, **Facebook Pages**, and **Beehiiv Newsletters**.
9. **CMS & Code Publishing**: WordPress REST API, custom Webhooks, and GitHub repository integration.

---

## 5. Canonical Public URLs

- Home: https://thisisagency.ai/
- LLMs Index: https://thisisagency.ai/llms.txt
- What Is an Agentic Agency?: https://thisisagency.ai/what-is-an-agentic-agency
- The Website Quality Rater Emulator: https://thisisagency.ai/the-website-quality-rater-emulator
- What Can Agency Connect To?: https://thisisagency.ai/what-can-agency-connect-to
- How to Use thisisagency.ai: https://thisisagency.ai/how-to-use-thisisagency-ai
- Who Is an Agentic Agency For?: https://thisisagency.ai/who-is-an-agentic-agency-for
- The Best Agentic Agency: https://thisisagency.ai/the-best-agentic-agency
- Meet Elsa: https://thisisagency.ai/elsa
- Shaun Anderson: https://thisisagency.ai/shaun-anderson
- Guides Index: https://thisisagency.ai/guides
- Google Search Console Guide: https://thisisagency.ai/how-to-connect-google-search-console-to-agency-a-complete-guide
- Google Analytics Guide: https://thisisagency.ai/how-to-connect-google-analytics-to-agency-a-complete-guide
- Editorial Policy: https://thisisagency.ai/editorial-policy
- Privacy Policy: https://thisisagency.ai/privacy
- Terms of Service: https://thisisagency.ai/terms