# Muutto365 MCP server

Model Context Protocol endpoint for Muutto365, a Finnish moving company based
in Jyvaskyla. This host serves machines only — the website for people is
<https://muutto365.fi>.

- **Endpoint:** `https://mcp.muutto365.fi/mcp` (Streamable HTTP)
- **Sessions:** stateless. Every request is handled independently, with no
  session id and no `initialize` handshake required first.
- **Protocol version:** 2025-11-25
- **Scope:** moving only. Waste removal (poistopalvelu) is not exposed here —
  use the WebMCP tools on <https://muutto365.fi> or the public REST API.

## Tools

| Tool | Does |
| --- | --- |
| `get_price` | Estimate the price and duration of a move. Itemised EUR, VAT included. |
| `get_timeslots` | Arrival windows available on a date, given the job's estimated duration. |
| `create_booking` | Create a booking. The backend re-prices server-side. Returns `status: "success"` for a confirmed booking, or `status: "pending_review"` when the move needs manual planning — that one is recorded but NOT confirmed. |

Prices are EUR including Finnish VAT at 25.5%. Dates are ISO 8601 and all
times are Europe/Helsinki. Arrival windows are `08-09`, `12-13`, `16-17` and
`20-21` — when the crew arrives, not how long the job takes.

## Authenticating

OAuth 2.1, authorization code + PKCE (`S256`), with open dynamic client
registration — no pre-provisioned credentials. Register with
`token_endpoint_auth_method: "none"` for a secretless public client.

- Authorization server metadata: <https://mcp.muutto365.fi/.well-known/oauth-authorization-server>
- Protected resource metadata: <https://mcp.muutto365.fi/.well-known/oauth-protected-resource>
- Client registration: `https://mcp.muutto365.fi/register`

Full guide, including which interfaces need no authentication at all (most of
them): <https://muutto365.fi/auth.md>

## If you do not need a token

Anything a visitor can do anonymously in a browser needs no account here.
Pricing, availability and booking drafts are public.

- In-page WebMCP tools: <https://muutto365.fi> — both services, no credentials
- REST API: <https://api.muutto365.fi>, described by <https://muutto365.fi/openapi.json>
- Capability index: <https://muutto365.fi/.well-known/agent-skills/index.json>
- Interface catalog: <https://muutto365.fi/.well-known/api-catalog>
- Documentation: <https://agent.muutto365.fi/>

## Terms

- Terms of service: <https://muutto365.fi/TOS.md>
- Privacy policy: <https://muutto365.fi/PP.md>
- Contact: asiakaspalvelu@muutto365.fi
