Virtual Colleague Developer and Agent Reference
> Read public information about Virtual Colleague's Filipino virtual assistant and business outsourcing services. Vercel hosts this migration preview; Virtual Colleague is the service provider.
When to use Virtual Colleague
Use these resources when a user is researching outsourced administrative support, bookkeeping, customer service, marketing, e-commerce, or industry-specific Filipino virtual assistants. Retrieve published role and industry pages, compare the described services, and direct interested users to a consultation. Published prices are reference information; confirm current scope and availability with the team.
Content and discovery
Request any existing page with Accept: text/markdown to receive clean Markdown; Accept: text/html keeps its normal design. Responses vary on Accept. Explicit alternatives include /index.md and /about-us/index.md. Unknown pages return HTTP 404 in the requested format with recovery links.
Read-only HTTP API
No authentication or API key is required for public information. All API operations below are GET requests and do not create enquiries or change data.
- GET /api/agent-search/?q=bookkeeping&limit=3: search published pages. Query: 1–200 characters. Limit: 1–10. Returns JSON results with title, description, URL and Markdown URL. Invalid input returns HTTP 400.
- GET /api/agent-content/?path=/virtual-assistant-roles/bookkeeping-va/: get the published page as Markdown. Unknown paths return HTTP 404. Only the local published catalog is accessible.
- GET /api/agent-contact/: get the public business name, phone, email and city-level address as JSON.
API versioning and typed errors
New integrations should use the stable major-version paths /api/v1/search/, /api/v1/pages/, and /api/v1/contact/ with the same query parameters described above. The original /api/agent-search/, /api/agent-content/, and /api/agent-contact/ URLs remain supported compatibility aliases. No operation is currently deprecated.
Breaking contract changes will use a new major version path. If an operation is scheduled for retirement, its developer documentation will announce at least 90 days of notice and its responses will carry Deprecation, Sunset and Link headers. Those headers are not sent for active, supported endpoints.
Search validation failures return HTTP 400 with RFC 9457 application/problem+json. The typed ProblemDetails schema in OpenAPI documents type, title, status, detail, instance, code and resolution. Codes invalid_query and invalid_limit distinguish the two recovery cases; the error field is a compatibility alias for detail. Error responses are not cached. Page-not-found responses from the page-content endpoint retain their documented Markdown format and HTTP 404 status.
Model Context Protocol
Connect a Streamable HTTP MCP client to **https://virtualcolleague.com.au/mcp/**. The official SDK service supports modern protocol 2026-07-28 and compatible legacy initialization (2025-11-25). It is stateless. Public tools require no authentication:
- search_site: query published Virtual Colleague content; pass query and optional limit.
- get_page: retrieve an existing page; pass its local path.
- get_contact_information: retrieve the public contact details; pass an empty object.
All tools are read-only, idempotent, and limited to this site's published catalog. There are no booking, hiring, payment or customer-record tools. Existing consultation and application forms continue to use their current services.
For legacy clients, POST JSON-RPC requests with Content-Type: application/json and Accept: application/json, text/event-stream; initialize before listing or calling tools. Modern clients use the current SDK's per-request metadata. A standalone GET SSE stream is not offered and returns 405. Discovery is available at /.well-known/mcp; that compatibility document is not a claim of MCP Registry registration.
Contact and identity
Virtual Colleague; hello@virtualcolleague.com.au; (08) 9515 7473; Perth, Western Australia, Australia. No street address is published. The primary canonical site remains virtualcolleague.com.au.