# RoboSim API and agent docs

> Size a Nexmow M2 mower fleet for any US golf course, with crew time and price. Free, no key.

RoboSim is Service Robot Co.'s simulator for robot mowing on golf courses. This API and MCP server let any AI agent or developer run a quick RoboSim estimate for a user. Base URL: `https://servicerobotco.com/api/v1/robosim` (GET it for the list of endpoints). Every endpoint returns JSON, or Markdown with `Accept: text/markdown`. No key, no sign-up.

## Quickstart (2 minutes)

- Prerequisites: any HTTP client (curl, fetch, requests). Nothing to install.
- Auth: none. No key, no account, no sign-up. Every endpoint and the MCP server are public and read-only.
- Data: public US golf course data (OpenStreetMap) and our RoboSim model. No customer data is read or stored.
- Limits: fair use; responses are cached for an hour. Estimates are quick ones; a full RoboSim on the course's own map is free.

1. **Find the course.** Search every US golf course by name. Each result has an id.

```bash
curl "https://servicerobotco.com/api/v1/robosim/courses?q=torrey+pines&state=CA"
```

2. **Run the estimate.** Get the recommended Nexmow M2 fleet for the roughs, crew hours freed a week, the yearly saving and the price.

```bash
curl "https://servicerobotco.com/api/v1/robosim/estimate?course=w35679036"
```

3. **Ask for Markdown.** Send Accept: text/markdown for an answer you can paste straight into a chat. No course? Give holes or acres.

```bash
curl -H "Accept: text/markdown" "https://servicerobotco.com/api/v1/robosim/estimate?holes=18&cutsPerWeek=3"
```

## Connect an AI agent (MCP)

Remote MCP server, streamable HTTP, no auth: https://servicerobotco.com/api/robosim/mcp

```json
{
  "mcpServers": {
    "robosim": {
      "url": "https://servicerobotco.com/api/robosim/mcp"
    }
  }
}
```

- `search_golf_courses`: Find a US course and its id.
- `estimate_robot_mower_fleet`: Nexmow M2 fleet, crew time, saving and price for a course.
- `get_robot_mower_pricing`: Lease term, setup and the three RoboCare plans.

## API reference

| Method | Path | What it does | Inputs |
| --- | --- | --- | --- |
| GET | `/api/v1/robosim/courses` | Find US golf courses by name. | q (required), state, limit (1 to 25) |
| GET or POST | `/api/v1/robosim/estimate` | RoboSim quick estimate for a course. | course or name (+state) or roughAcres or courseAcres or holes; cutsPerWeek (1 to 7, default 2.5) |
| GET | `/api/v1/robosim/pricing` | Nexmow M2 pricing. | none |
| GET | `/openapi.json` | OpenAPI 3.1 description of the API. | none |

Full description: https://servicerobotco.com/openapi.json

## Pricing: Nexmow M2 for golf course roughs

Leased through financing on a 36-month lease, one fixed payment a month. Hardware refresh at year 3. $0 setup: docks, mapping, crossings, schedules and training.

| RoboCare plan | Regular, per Nexmow M2 a month | Partner course rate | Service visits a year (fleet) | Extras |
| --- | --- | --- | --- | --- |
| Full Care | $945 | $845 | 8 | Replacement blades shipped to you, Priority onsite support |
| Base Care | $795 | $695 | 4 | Replacement blades shipped to you |
| Lite Care | $695 | $595 | Billed as used | None |

Partner course rate: A lower price for the first courses we work with.

Every plan includes:
- 24/7 support, a technical specialist answers in 10 minutes
- 24/7 monitoring
- Robot, battery and accessories warranty
- Software updates over the air
- App for live monitoring and a weekly full report
- Onsite support from local technicians
- Winterization
- Eligible for trade-in toward newer models

Uptime promise: If a robot goes down and we can't get it back up quickly, you stop paying for it until it's running again. We also add free service visits on us. In the worst case, we lend you a loaner robot, when available.

A full RoboSim of your course on its own map is free. Book it: https://servicerobotco.com/book

Other robots (cleaning, delivery, security, warehouse) are quoted per site after a free simulation.

## How the estimate works

Rough acres come from what you give, else the course's mapped outline in GCSAA median proportions (49 of 146 acres), else its hole count. The fleet is sized at 9.6 acres of rough per Nexmow M2 a week, the mean of our full RoboSim runs on 7 real course maps (8.3 to 10.6). Crew time is 40 minutes of paid crew time an acre by hand. A full RoboSim on the course's own map is free and fixes the fleet and the price.

- [See a course on the map](https://servicerobotco.com/golf)
- [Book a free full RoboSim](https://servicerobotco.com/book)

## For agents reading this site

- Any page answers in Markdown when asked with `Accept: text/markdown`, or add `.md` to its path.
- Site map for AI assistants: https://servicerobotco.com/llms.txt
- This page: https://servicerobotco.com/docs
