# Aunoo Agentic

> The news and foresight harness for agentic AI. Live news coverage with provenance and trust signals, forecasts on where stories are heading, and newsletters on demand, served to AI agents over MCP. Free to start.

Aunoo Agentic is an MCP server. It gives an AI agent grounded, cited answers from current news coverage: who is behind a story (source reliability, ownership, state affiliation, coordinated amplification), where consensus and outliers sit, and where a topic is heading. Other APIs hand your agent articles; Aunoo hands it judgment.

## Connect

- MCP endpoint (Streamable HTTP, POST only): `https://saas.aunoo.ai/mcp`
- Auth: OAuth 2.1 with dynamic client registration and PKCE (S256). Metadata: `https://saas.aunoo.ai/.well-known/oauth-authorization-server` and `https://saas.aunoo.ai/.well-known/oauth-protected-resource`. An unauthenticated request gets a 401 whose WWW-Authenticate header points at that metadata.
- Claude Code: `claude mcp add aunoo https://saas.aunoo.ai/mcp --transport http` then `/mcp` → Authenticate.
- Claude Desktop / claude.ai: Settings → Connectors → Add custom connector, paste the MCP URL, sign in.
- Static key alternative: mint a workspace key in the console (https://saas.aunoo.ai/agentic/console) and send `Authorization: Bearer aunoo_…`.
- REST mirror of every tool: `POST https://saas.aunoo.ai/api/v1/skills/workspace/run` with `{"tool": name, "arguments": {...}}` and the same bearer.
- Server card (SEP-2127): `https://saas.aunoo.ai/mcp/server-card`; catalog: `https://saas.aunoo.ai/.well-known/ai-catalog.json`.

## Sign up and pay as an agent

1. Read the offer: `GET https://saas.aunoo.ai/api/v1/agentic/offer` (public; prices, limits, scopes).
2. Register a client: `POST https://saas.aunoo.ai/oauth/register` with `{"client_name": "my-agent", "grant_types": ["urn:ietf:params:oauth:grant-type:device_code"]}`.
3. Start the device flow: `POST https://saas.aunoo.ai/oauth/device_authorization` (form fields `client_id`, optional `scope`). Show the returned `verification_uri_complete` to your human; they sign in with Google or GitHub once and approve. A free workspace is created on that page.
4. Poll `POST https://saas.aunoo.ai/oauth/token` with `grant_type=urn:ietf:params:oauth:grant-type:device_code` until it returns tokens (`authorization_pending` and `slow_down` in between).
5. Call `/mcp` with the access token. Default scope is `mcp:workspace account:topics`; request `account:billing` too if the agent should be able to buy add-ons.
6. Buy an add-on: `POST https://saas.aunoo.ai/api/v1/billing/addons` `{"kind": "skills_addon_foresight", "quantity": 1}` returns a `checkout_url` for your human and a `poll_url`; poll it every 5 s until `fulfilled` is true.

## Tools

Topic-scoped arguments are auto-filled from the topics the workspace subscribes to. Call `list_capabilities` first to learn the topic ids.

- `analyze_sentiment_trends` — Sentiment trends: Aggregate sentiment trends over time
- `fetch_related_to_article` — Related articles: Return articles semantically similar to a given article id via pgvector KNN.
- `follow_up_query` — Follow-up search: Combine previous context with new query results
- `forecast_sentiment_inflection` — Sentiment inflection forecast: Forecast whether a topic's sentiment is about to turn — momentum, the most recent change-point (date + direction + size), and an inflection-risk flag with a projected sign-flip…
- `forecast_topic_trajectory` — Topic trajectory forecast: Forecast a topic's lifecycle phase from its daily article-volume curve — emerging / accelerating / cresting / declining / dormant — with growth rate and, when a curve fits, a pr…
- `get_article_categories` — Article categories: Get category distribution for a topic
- `get_article_full` — Full article: Fetch a single article by id with full content (no 2000-char truncation).
- `get_consensus` — Consensus and outliers: Return Aunoo's cached cross-source consensus analysis for a topic — 3-5 categories where coverage converges, with key insights and source breakdown.
- `get_entity_wiki` — Entity wiki: Fetch the LLM-maintained wiki summary for a named entity within a topic — who they are, when they appeared, key events involving them.
- `get_foresight_component` — Foresight component: Get Aunoo's ACTUAL in-app chart for a topic as a self-contained HTML document (same server-rendered SVG as the app + public share page: the S-curve with scenarios plotted on it,…
- `get_horizons` — Future horizons: Return Aunoo's cached Three-Horizons foresight scenarios for a topic — current developments (H1), emerging shifts (H2), longer-horizon possibilities (H3).
- `get_newsletter_job` — Newsletter job status: Poll the status of a queued newsletter job.
- `get_polarization_index` — Polarization index: Measure how far apart the left and right are framing a topic — a 0–100 score for how separable left- vs right-leaning coverage is in embedding space, plus a trend (widening / na…
- `get_story_coverage` — Story coverage report: Coverage read for a news article: who else is running the SAME story, and Aunoo's verdict on how it's moving — reach (niche / regional / wide / viral), coordination (none / susp…
- `get_topic_articles` — Topic articles: Fetch articles for a specific topic with optional sampling
- `get_trust_signals` — Trust signals for an article: The five per-article Trust Signals Aunoo shows in the app — ① Source (outlet bias / factual record / credibility) ② Claims (per-claim verdicts when the article has been validate…
- `get_trust_signals_for_urls` — Trust signals for URLs: The same five Trust Signals as get_trust_signals, for articles named by URL rather than by Aunoo article id — up to 25 urls.
- `get_validation_job` — Validation job status: Poll the status of a queued validation job.
- `get_world_state` — World state: Returns the platform's maintained record of current entities, topic state, and recent events.
- `list_capabilities` — List capabilities: Return a chat-friendly summary of what this Aunoo connection can do — packs in scope, tool catalogue, named recipes, and a 'how to get started' hint.
- `list_newsletter_jobs` — List newsletter jobs: List the calling tenant's most recent newsletter jobs (default 10, max 50).
- `render_horizons_chart` — Render horizons chart: Render the Three-Horizons foresight as a PNG chart — the same S-curve visual as the in-app Future Horizons page (current H1 declining, transition H2 cresting, future H3 rising)…
- `search_articles_by_keywords` — Keyword search: Keyword search across title, content, and summary
- `search_news` — Search news: Search for news articles (semantic + keyword fallback)
- `semantic_search_and_analyze` — Semantic search and analysis: Vector search for semantically similar articles
- `start_newsletter_job` — Start newsletter job (starts a job): Run Aunoo's server-side newsletter generator.
- `start_validation_job` — Start validation job (starts a job): Queue an independent article fact-check as a background job and return a job_id immediately.
- `validate_article` — Validate article claims (starts a job): Run an independent fact-check on a news article: extracts claims, verifies each against source reputation, corroboration across outlets, external fact-check archives, and synthe…

## Playbooks (MCP prompts)

Multi-step playbooks returned by `prompts/get`; the agent then follows them with the tools above.

- `deep_dive`: Research-style multi-angle dive on a question.
- `consensus_analysis`: Identify 3-4 consensus categories where coverage converges + where it diverges.
- `future_horizons`: Standardized, VISUAL Three-Horizons foresight for a topic: pulls get_horizons + the canonical S-curve, then renders Aunoo's future-horizons component as an artifact (HTML/text f…
- `consensus_outliers`: Standardized, VISUAL Consensus & Outliers for a topic: pulls get_consensus, then renders Aunoo's consensus component (sentiment mix + agreement + minority outliers) as an artifa…
- `foresight_report`: Build ONE cohesive, on-brand report artifact for a topic — orchestrates the full foresight set: the Three-Horizons chart (Aunoo SVG) + scenarios, the computed volume / sentiment…
- `newsletter`: Multi-step playbook for drafting a topic-scoped newsletter in Aunoo's house voice.
- `correspondent_brief`: Short-form briefing (200-300 words) in the voice of a named Aunoo correspondent persona.
- `forecast_brief`: Forward-looking outlook for a topic built from Aunoo's three COMPUTED forecast signals: volume trajectory (lifecycle phase + projected peak), sentiment inflection (is the mood t…
- `investigation`: Rigorous, evidence-first investigation + fact-check of a claim, article, or URL.
- `story_reach`: Trace how a story spread on the covered social platforms and how it was received, and present it as a structured reach card (Spread → Top amplifiers → Reception).

## Pricing

- Free (Reader): $0. 1 subscribed topic(s) and the core toolset above.
- Free-tier cap: 100 tool calls per month. The Agent plan removes the cap; feature add-ons do not.
- Agent plan (`agent`): $19/month. 2000 tool calls included, then 0.01 USD per call; 3 topics; no monthly cap. Buy with POST /api/v1/billing/plans/change {"plan": "agent"}.
- Additional Topic (`topic`): $3/month. One more subscribed topic per unit (raises max_topics by 1).
- Foresight Tools (Consensus + Horizons) (`skills_addon_foresight`): $19/month. The foresight tools: get_consensus, get_horizons, render_horizons_chart, get_foresight_component, forecast_topic_trajectory, forecast_sentiment_inflection, get_polarization_index.
- Newsletter Generator (`skills_addon_newsletter`): $15/month. The newsletter tools: start_newsletter_job, get_newsletter_job, list_newsletter_jobs.
- Add-ons are billed monthly and prorated; cancel from the console.

## Links

- Full tool reference with parameters: https://saas.aunoo.ai/llms-full.txt
- Human-readable docs: https://saas.aunoo.ai/api/v1/skills-docs/docs
- OpenAPI (REST mirror): https://saas.aunoo.ai/openapi.json
- ChatGPT Actions manifest: https://saas.aunoo.ai/api/v1/skills/workspace/openapi.yaml
- Public RSS of open topics: https://saas.aunoo.ai/api/v1/public/feeds/news.xml
- Privacy: https://saas.aunoo.ai/legal/privacy · Terms: https://saas.aunoo.ai/legal/terms
- Security contact: https://saas.aunoo.ai/.well-known/security.txt