# Write On Speak Out
> Write On Speak Out is a platform curated by the Write On School for Young Writers, a not-for-profit organization based in New Zealand. The site provides a dedicated space for young writers worldwide to share their work, offering mentorship, workshops, and publication opportunities. It features various projects like 'Fresh Voices,' 'Lockdown Voices,' and 'Voices for the Planet,' showcasing the creative output of young individuals. The initiative aims to encourage, inspire, enable, and guide young writers, empowering them to express their ideas and develop their unique voices. The platform also hosts a podcast, 'Young Writers Yap,' created by graduates and students of the school.

## AI Agent Access

This site is powered by Wix and supports the Model Context Protocol (MCP)
for agentic AI access. AI agents can connect directly to retrieve live,
up-to-date site content - no scraping required.

- **Site MCP Endpoint:** https://www.writeonspeakout.org/_api/mcp
- **Wix MCP Docs:** https://dev.wix.com/docs/develop-websites/articles/get-started/about-the-wix-site-mcp

## Available MCP Tools

### GetBusinessDetails
Retrieves business and site details such as timezone, email, phone, and address.
- No parameters required.

### SearchInSite
Searches the site for information.
- \`searchTerm\` - The term to search for in the site.

### SearchSiteApiDocs
Retrieves the API documentation for the Wix business solutions installed on
this site, and informs the AI client how to use the APIs. Use this tool for
querying products and services (instead of SearchInSite).
- \`searchTerm\` - The term to search for in the site API documentation.

### GenerateVisitorToken
Creates a new visitor session and obtains a visitor access token for the site.
Must be called before making any CallWixSiteAPI request if no visitor token
is already available in context.
- No parameters required.

### CallWixSiteAPI
Calls API methods on the site to perform actions on a visitor's behalf,
such as querying site data, booking an appointment, or starting a purchase.
- \`visitorToken\` - Visitor access token. Use GenerateVisitorToken first if not available.
- \`url\` - Absolute URL of the API method to call (e.g. https://www.wixapis.com/...). Retrieve using SearchSiteApiDocs.
- \`method\` -  HTTP method to use for the API call.
- \`body\` -  Request body as a valid JSON string.

### ReadFullDocsArticle
Fetches a complete article from the Wix developer documentation portal.
- \`articleUrl\` -  URL of an article in the Wix developer documentation portal.

### ReadFullDocsMethodSchema
Fetches the full schema for a Wix API method. Should be called before
calling the actual method via CallWixSiteAPI.
- \`articleUrl\` - URL of the reference article for the Wix API method.

## What Visitors Can Do via AI + MCP

- Get business details (contact info, location, hours)
- Discover products and services on offer
- Book services and make reservations
- Start a purchase and be directed to the site to complete checkout
- Ask questions and get relevant answers without having to browse the site

## Notes

- No authentication required to connect to the MCP endpoint
- Only public information accessible on the site is available
- Content is always live and up to date
- To receive tool updates, implement a tools/list call upon receipt of a tool update notification