AMCP Website - Broken Links Report

Date: November 11, 2025
Website: https://agentmeshcommunicationprotocol.github.io/
Total Links Checked: 40
Working Links: 24 ✅
Broken Links: 15 ❌

Summary

Category Count Status
Working Links 24 ✅
Broken Links 15 ❌
Success Rate 61.5% ⚠️
Link Status Purpose Priority
/community/contributing/ 404 Contributing guidelines for developers HIGH
/community/discussions/ 404 Community discussions and Q&A HIGH
/community/roadmap/ 404 Project roadmap and future plans MEDIUM

Action: Create these community pages to engage developers and show project direction.

Link Status Purpose Priority
/docs/changelog/ 404 Version history and release notes HIGH
/docs/migration/ 404 Migration guide from v1.5 to v1.6 HIGH
/docs/tutorials/first-agent.html 404 Beginner tutorial for first agent CRITICAL

Action: These are essential documentation pages. Create them immediately.

Link Status Purpose Priority
/examples/meshchat/ 404 Mesh chat example application MEDIUM
/examples/orchestration/ 404 Orchestration example MEDIUM

Action: Create example applications to demonstrate AMCP capabilities.

Link Status Purpose Priority
/contact/ 404 Contact form or contact information MEDIUM
/privacy/ 404 Privacy policy HIGH
/support/ 404 Support and help resources MEDIUM
/terms/ 404 Terms of service HIGH

Action: Create legal pages for compliance and user support.

Link Status Purpose Priority
https://fonts.googleapis.com 404 Google Fonts CDN CRITICAL
https://fonts.gstatic.com 404 Google Fonts static assets CRITICAL
https://github.com/agentmeshcommunicationprotocol/amcpcore 404 Main GitHub repository CRITICAL

Action: These are critical external resources. Verify URLs and update configuration.

Documentation & Resources ✅

  • / - Homepage
  • /docs/ - Documentation hub
  • /docs/api-reference/ - API documentation
  • /docs/architecture/ - Architecture guide
  • /docs/best-practices/ - Best practices
  • /docs/getting-started/ - Getting started guide
  • /docs/installation/ - Installation instructions
  • /docs/kafka-integration.html - Kafka integration guide
  • /docs/quarkus-extension.html - Quarkus extension guide

Community & Blog ✅

  • /blog/ - Blog posts
  • /community/ - Community hub
  • /examples/ - Examples hub
  • /examples/stock-agent/ - Stock agent example
  • /examples/travel-agent/ - Travel agent example
  • /examples/weather-agent/ - Weather agent example

Additional Resources ✅

  • /download/ - Download page
  • /whitepaper/ - Whitepaper
  • /feed.xml - RSS feed
  • /assets/css/main.css - Main stylesheet
  • /assets/images/apple-touch-icon.png - Apple touch icon
  • /assets/images/favicon.ico - Favicon
  • https://github.com/agentmeshcommunicationprotocol/amcpcore.github.io - GitHub Pages repo
  • https://twitter.com/amcp_framework - Twitter account

Priority Action Plan

CRITICAL (Fix Immediately)

  1. Fix external links
    • Verify Google Fonts URLs
    • Update GitHub repository URL
    • Test font loading
  2. Create first-agent tutorial
    • Essential for onboarding
    • High SEO value
    • Directly referenced in homepage

HIGH (Fix This Week)

  1. Create documentation pages
    • /docs/changelog/ - Version history
    • /docs/migration/ - Migration guide
    • /privacy/ - Privacy policy
    • /terms/ - Terms of service
  2. Create community pages
    • /community/contributing/ - Contributing guide
    • /community/discussions/ - Discussion links

MEDIUM (Fix Next Week)

  1. Create example applications
    • /examples/meshchat/ - Mesh chat demo
    • /examples/orchestration/ - Orchestration demo
  2. Create support pages
    • /contact/ - Contact form
    • /support/ - Support resources
    • /community/roadmap/ - Project roadmap

Recommendations

# Update _config.yml
google_fonts_url: "https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
github_repo: "https://github.com/agentmeshcommunicationprotocol/amcpcore"

2. Create Missing Pages

Priority 1 (This week):
- docs/tutorials/first-agent.md
- docs/changelog.md
- docs/migration.md
- privacy.md
- terms.md

Priority 2 (Next week):
- community/contributing.md
- community/discussions.md
- community/roadmap.md
- examples/meshchat/index.md
- examples/orchestration/index.md
- contact.md
- support.md

3. SEO Impact

  • Missing pages reduce SEO value
  • Broken links harm user experience
  • 404 errors indicate incomplete site
  • Recommendation: Fix all links before major promotion

Implementation Checklist

  • Verify Google Fonts URLs
  • Update GitHub repository URL
  • Test all external links

Critical Pages

  • Create /docs/tutorials/first-agent.html
  • Create /docs/changelog/
  • Create /docs/migration/
  • Create /privacy/
  • Create /terms/
  • Create /contact/
  • Create /support/

Community Pages

  • Create /community/contributing/
  • Create /community/discussions/
  • Create /community/roadmap/

Example Applications

  • Create /examples/meshchat/
  • Create /examples/orchestration/

Testing Commands

# Test all links
curl -s https://agentmeshcommunicationprotocol.github.io/ | grep -oP 'href="\K[^"]+' | sort -u

# Test specific link
curl -I https://agentmeshcommunicationprotocol.github.io/docs/tutorials/first-agent.html

# Test external links
curl -I https://fonts.googleapis.com
curl -I https://github.com/agentmeshcommunicationprotocol/amcpcore

Next Steps

  1. Immediate (Today)
    • Fix external links
    • Create first-agent tutorial
  2. This Week
    • Create all critical documentation
    • Create legal pages
  3. Next Week
    • Create community pages
    • Create example applications
    • Verify all links working

Report Generated: November 11, 2025
Status: ⚠️ Action Required - 15 broken links need fixing