Skip to content

content(library): add observability, procurement, and MCP security guides - #5928

Merged
waleedlatif1 merged 2 commits into
stagingfrom
improvement/library-observability-procurement-mcp
Jul 24, 2026
Merged

content(library): add observability, procurement, and MCP security guides#5928
waleedlatif1 merged 2 commits into
stagingfrom
improvement/library-observability-procurement-mcp

Conversation

@waleedlatif1

Copy link
Copy Markdown
Collaborator

Summary

Three new AEO library guides, each dated into a recent empty day in the posting calendar so publication is spread out rather than dumped on one day:

Post Date (backfilled gap) Focus keyword
ai-agent-observability 2026-07-19 (Sun, empty) ai agent observability
ai-agents-in-procurement 2026-07-21 (Tue, empty) ai agents in procurement
mcp-security 2026-07-22 (Wed, empty) mcp security

Note the three provided slugs were /blog/..., but the content is textbook AEO/GEO (focus keyword, meta description, key takeaways, FAQ) and you asked for the library — so they live at /library/<slug>, matching the section's purpose. canonical and internal links use /library/.

Citations — every claim traced to a verified primary source

Per .claude/rules/landing-seo-geo.md, every third-party factual claim carries an outbound citation, and I verified each source actually substantiates the claim before linking it (not just that the URL resolves):

One correction to the source copy: it stated the WhatsApp MCP flaw was found "In November 2025." I could not verify that date (the disclosure was earlier in 2025), so I dropped the specific month rather than assert it — the case itself is cited to Docker's writeup. Per the rule: an unlinked/undated claim beats a wrong one.

Internal links: 3 per post to related library posts (e.g. procurement → AI agents vs RPA, MCP security → what an MCP server is). No self-links; all internal targets exist.

Covers

Cover art comes from your autogeneration pipeline. Each post references the standard ogImage: /library/<slug>/cover.jpg path; I did not commit placeholder art. Until autogen runs, the hero image at those three paths will 404 — flagging so it's not a surprise.

Testing

Verified against a running dev server:

  • All 3 pages render 200; all 3 appear in the /library index with correct dates.
  • All 17 unique external URLs resolve (mcpmarket.com returned 429 from my own repeated hits — a live site, not a 404).
  • Rendered link treatment: every external citation carries target="_blank" rel="noopener noreferrer" (5/5, 4/4, 9/9); internal links carry neither. (This relies on the MDX-anchor fix from improvement(library): add citations and internal links, correct stale pricing #5913, now on staging.)
  • Tables and heading hierarchy render correctly; FAQ schema present; no "Updated" label (date == updated on new posts).
  • bun run lint clean; check:boundaries, check:api-validation:strict, check:client-boundary all pass.

Heads-up unrelated to this PR: bunx tsc reports 5 errors in providers/anthropic/core.ts (Anthropic SDK OutputConfig/output_config typings). These are pre-existing on staging — this PR adds only MDX, which tsc doesn't compile — but worth a look since they'll trip a full typecheck.

Type of Change

  • Content

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

…ides

Three AEO guides, each dated into a recent empty day in the posting
calendar (2026-07-19, 07-21, 07-22) so publication is spread across days
rather than dumped on one.

- ai-agent-observability: what observability is, why APM falls short for
  non-deterministic agents, what to instrument per lifecycle stage, and the
  signals to track
- ai-agents-in-procurement: what procurement agents do, buy-vs-build, where
  they add value, and how to start narrow
- mcp-security: tool poisoning, confused-deputy/OAuth flaws, and supply-chain
  risk, plus how to build and govern MCP servers securely

Every third-party factual claim carries an outbound citation to a verified
primary source (OpenTelemetry semconv, Fiddler, LangChain and PwC surveys,
Icertis/ProcureCon, Ironclad, GEP, the MCPoison/CurXecute CVEs on NVD,
Anthropic's MCP announcement, RFC 8707/9700, OAuth 2.1, the MCP auth spec),
and each post carries 3 internal links to related library posts. One claim
from the source copy — a "November 2025" date on the WhatsApp MCP exfil case
— could not be verified and was dropped; the case itself is cited to Docker's
writeup. Covers come from the autogeneration pipeline via the standard
/library/<slug>/cover.jpg path.
@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
docs Skipped Skipped Jul 24, 2026 5:53pm

Request Review

@cursor

cursor Bot commented Jul 24, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Documentation-only MDX under content/library; no runtime, auth, or data-path changes.

Overview
Adds three new /library AEO guides as MDX-only content, each with its own slug, staggered 2026-07-19 / 21 / 22 dates, FAQ frontmatter, canonical URLs, ogImage paths, and internal links to existing library posts.

ai-agent-observability covers traces/logs/metrics/evals, why APM falls short for agents, lifecycle instrumentation, and getting started (with cited third-party stats and OpenTelemetry links).

ai-agents-in-procurement explains agent vs RPA/software, high-value use cases, buy vs build, rollout steps, and governance challenges.

mcp-security maps MCP threat models (tool poisoning, OAuth, supply chain), hardening and production governance, with CVE and spec citations.

No application code changes; cover images are referenced but not committed in this diff (autogen pipeline).

Reviewed by Cursor Bugbot for commit a0989bb. Configure here.

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cursor review

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 2e45cc5. Configure here.

@greptile-apps

greptile-apps Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Adds three dated AEO library guides:

  • Introduces an AI agent observability guide.
  • Introduces an AI agents in procurement guide.
  • Introduces an MCP security guide.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains within the scope of the previous review thread.

Important Files Changed

Filename Overview
apps/sim/content/library/ai-agent-observability/index.mdx Adds the observability guide with metadata, FAQs, citations, and related library links.
apps/sim/content/library/ai-agents-in-procurement/index.mdx Adds the procurement guide with metadata, FAQs, cited adoption data, and implementation guidance.
apps/sim/content/library/mcp-security/index.mdx Adds the MCP security guide with metadata, FAQs, cited threat examples, and security recommendations.

Reviews (2): Last reviewed commit: "fix(library): correct two unverifiable c..." | Re-trigger Greptile

Comment thread apps/sim/content/library/ai-agent-observability/index.mdx
Accuracy pass on the three new posts turned up two claims that could not be
substantiated:

- HIPAA compliance: the procurement post claimed Sim has "SOC2 and HIPAA
  compliance," but the canonical compliance data (lib/compare/data/sim.ts)
  states SOC2 only, and explicitly that Sim offers self-hosting "beyond SOC2,
  rather than additional certifications." Removed HIPAA; kept SOC2 plus
  self-hosting for data residency. (The same claim exists in ~5 pre-existing
  library posts and should be corrected separately.)
- "more than 18,000 servers were listed on MCP Market": no source
  substantiates this figure. Replaced with "thousands of community-built
  servers," which the ecosystem supports, keeping the Anthropic and MCP Market
  links.

Every other third-party claim was verified against a primary source (both
CVEs on NVD, RFC 8707 title, RFC 9700 as January 2025, and all six survey
statistics).
@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cursor review

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit a0989bb. Configure here.

@waleedlatif1
waleedlatif1 merged commit e83d8b8 into staging Jul 24, 2026
14 of 15 checks passed
@waleedlatif1
waleedlatif1 deleted the improvement/library-observability-procurement-mcp branch July 24, 2026 17:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant