# Vyuh Drift — Model Context Protocol (MCP) Server

> Vyuh Drift is the deterministic, verifiable social publishing and campaign execution operating system for AI agents and human creators.

## Machine-Readable Resources
- **MCP Server Endpoint**: https://drift.vyuhmatrix.com/api/mcp
- **OAuth 2.1 Protected Resource Discovery (RFC 9728)**: https://drift.vyuhmatrix.com/.well-known/oauth-protected-resource
- **OAuth 2.0 Authorization Server Metadata (RFC 8414)**: https://drift.vyuhmatrix.com/.well-known/oauth-authorization-server
- **Full LLMs Specification**: https://drift.vyuhmatrix.com/llms-full.txt
- **Developer & Agent Guide**: https://drift.vyuhmatrix.com/agents.md
- **Interactive Sandbox & Web Console**: https://drift.vyuhmatrix.com/developers

## Authentication
1. **OAuth 2.1 (Recommended for Autonomous Agents)**:
   - Dynamic Client Registration: `POST https://drift.vyuhmatrix.com/api/oauth/register`
   - Authorization: `GET https://drift.vyuhmatrix.com/oauth/authorize` (PKCE S256 required)
   - Token Exchange: `POST https://drift.vyuhmatrix.com/api/oauth/token`
   - Scopes: `mcp:read`, `mcp:write`
2. **Static API Key**:
   - Send `Authorization: Bearer vyuh_...` or `x-api-key: vyuh_...` header.

## Available MCP Tools (9 Reviewed Tools)
- **list_channels**: Lists every connected channel together with its credential health, its autopublish policy (whether an agent may publish here without a human… (Read-Only: true)
- **channel_rules**: Provides platform limits, character lengths, thread support, and required fields before drafting content. Call this to know exact character … (Read-Only: true)
- **get_post_metrics**: Fetches real, unpadded platform engagement metrics (likes, reposts, comments, impressions) for a post. Never invents figures or estimates ra… (Read-Only: true)
- **check_post**: Reports what the PLATFORM says about a post, not what this app recorded when it was sent — catching the gap between the two is the whole poi… (Read-Only: true)
- **publish**: Publishes or schedules a post across one or more channels. Channels whose autopublish policy is APPROVAL (see list_channels) are staged for … (Read-Only: false)
- **list_pending_approvals**: Lists posts that are staged on an APPROVAL channel and blocked on a human before they can go out. Each entry includes an approvalUrl — the p… (Read-Only: true)
- **recon_domain**: Universal Domain Context Profiler. Extracts a target website or competitor domain's vertical, tech stack, ICP buyer personas, key pain point… (Read-Only: true)
- **scan_outliers**: Vertical Outlier Radar. Scans public discussions, news, and social feeds for mathematical anomalies and breakout viral posts (3x-10x median … (Read-Only: true)
- **export_sales_outreach**: Cold Outbound Sequence Exporter. Mines competitor friction points and outputs a battle-tested 3-touch outreach sequence (Day 1 problem, Day … (Read-Only: true)

## Verification Engine
Unlike schedulers that treat an API 200 as success, Vyuh Drift fetches each published post back from the platform by its remoteId and records what it found. The result is a public receipt at `https://drift.vyuhmatrix.com/r/<token>` showing the scheduled time, the publish time, the platform's own record id, and whether the post was confirmed live, missing, or could not be re-checked.

### Verification States:
- **VERIFIED**: The post was fetched back from the live platform API and is verified visible.
- **MISSING**: The platform accepted the publish request but the post is not visible (removed or failed silently).
- **UNVERIFIABLE**: The platform cannot be read back; Vyuh reports honest uncertainty.