AI & Agent Interfaces

Three ways in

• MCP server — a Model Context Protocol server over Streamable HTTP at https://www.twistteams.com/api/mcp. Best for assistants and backend agents.
• WebMCP — the same tools registered in-page on document.modelContext for agents running inside the browser.
• Text corpus — /llms.txt for a structured summary and /llms-full.txt for the complete corpus. Best for retrieval and crawling.

MCP server

Endpoint

https://www.twistteams.com/api/mcp

Connect to the www host directly. The apex domain issues a 308 redirect and many MCP clients do not follow redirects on POST.

Transport

Streamable HTTP. Stateless — no session identifier is required.

Protocol versions

2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07. The server negotiates down to the version your client requests.

Authentication

None. The endpoint is public and read-only. Do not send credentials, API keys or personal data to it.

Rate limits

No application-level rate limit is enforced. The endpoint sits behind standard platform protections, so treat it as best-effort and back off on errors rather than assuming a published quota.

Errors

Tool failures return a normal MCP result with isError: true and a human-readable message — for example an unrecognised role name tells you to call list_roles. Malformed arguments return a validation error naming the offending field. Errors are never returned as empty successes.

Privacy

Tool calls reach TwistTeams infrastructure and may appear in ordinary server logs. No tool accepts or stores personal data, and none writes to a database. See our Privacy Policy.

Tool catalogue (7 tools)

The MCP server and the in-page WebMCP surface expose an identical set, built from a single definition, so an agent gets the same capabilities whichever route it takes.

get_company_info

Get company info

TwistTeams corporate profile: an Australian-owned offshore staffing provider in Clark, Philippines. Returns positioning, tenure, operating entities, offices (Philippines / Hong Kong / Singapore) and contact details.

Read-only — retrieves published information.

get_services

Get services

Offshore staffing offering: what's included (recruitment, onboarding, HR & payroll, office infrastructure, performance management, retention), the step-by-step process, the pricing model, and the roles TwistTeams fills.

Read-only — retrieves published information.

get_why_twistteams

Why the Philippines & why TwistTeams

The case for offshoring to the Philippines, why Clark specifically, and why TwistTeams over a generic staffing agency.

Read-only — retrieves published information.

get_team

Get team

TwistTeams directors — names, titles and locations.

Read-only — retrieves published information.

list_roles

List roles

List the 93 offshore roles TwistTeams recruits for, grouped across 14 specialisations. Each role has a stable id usable with estimate_role_cost.

Read-only — retrieves published information.

estimate_role_cost

Estimate role cost

Indicative monthly cost for one role: the all-in TwistTeams figure versus a fully-loaded local hire, with the saving. Figures are indicative, not a quote.

Read-only — retrieves published information.

book_consultation

Book a consultation

How to book a free 30 minute consultation with a TwistTeams advisor. Returns the booking link and contact details.

Read-only — retrieves published information.

Side effects and booking

Every tool listed above is read-only, and nothing here can commit you to anything. All seven retrieve published information and return it. None writes to a database, sends an email, or creates a record.

book_consultation is deliberately not an exception. Despite its name it does not create a booking — it returns our booking link and email address. A human still has to open that link and choose a time, so a consultation can never be scheduled by an agent acting alone. This is a design decision, not a limitation: booking is the point at which a person should be in the loop.

If a tool is ever added that genuinely writes, it will be declared here and marked with readOnlyHint: false in its annotations.

Cost figures

estimate_role_cost returns indicative monthly figures comparing a TwistTeams hire against a fully-loaded onshore hire, across four markets and three seniority levels. These are planning figures, not a quote, and every response says so in its note field. Please preserve that qualification when quoting the numbers back to a user.

WebMCP

On pages loaded in a browser, the same tools are registered on document.modelContext using the W3C Web Machine Learning Community Group draft. We also read the deprecated navigator.modelContext location so agents on older builds still work. Tools are unregistered via an AbortSignal when the page unmounts.

WebMCP is an incubating specification and has already changed in breaking ways. If you are integrating against it, prefer the MCP server above for anything durable.

Crawling

Our robots.txt explicitly allows the major AI search and assistant crawlers. Only /api/ is disallowed — it is an agent endpoint, not indexable content. Page content is server-rendered, so it is fully available without executing JavaScript.