Biohotspot is an MCP server published by io.github.PascalSun, hosted at biohotspot.ai4wa.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 31 tools, including look_here, look_in_area, understand_area, simulate, list_scenarios.
Ocean data for any coast or sea, Australian marine park facts and Marxan reserve design.
2 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List every Biohotspot map layer with data within `km` of a point on the sea (a place being studied, not the user's location): habitats, wildlife, human uses, protected areas and world ocean maps, with its nearest few items each. Read-only. Use it to learn what a place holds; give `layer` (an id from the answer) for that layer in full.
| Parameter | Type | Description |
|---|---|---|
| km | number | Radius in km (default 5) |
| lat * | number | Latitude of the place to look at, WGS84 |
| lon * | number | Longitude of the place to look at, WGS84 |
| layer | string | A layer id from an earlier answer: that layer in full, alone |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "look_here",
"title": "Look at a place",
"description": "List every Biohotspot map layer with data within `km` of a point on the sea (a place being studied, not the user's location): habitats, wildlife, human uses, protected areas and world ocean maps, with its nearest few items each. Read-only. Use it to learn what a place holds; give `layer` (an id from the answer) for that layer in full.",
"inputSchema": {
"type": "object",
"required": [
"lon",
"lat"
],
"properties": {
"km": {
"type": "number",
"description": "Radius in km (default 5)"
},
"lat": {
"type": "number",
"description": "Latitude of the place to look at, WGS84"
},
"lon": {
"type": "number",
"description": "Longitude of the place to look at, WGS84"
},
"layer": {
"type": "string",
"description": "A layer id from an earlier answer: that layer in full, alone"
}
}
},
"annotations": {
"title": "Look at a place",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List every Biohotspot map layer with data inside a polygon on the sea, with its nearest few items each. Read-only. Give `layer` (an id from the answer) for that layer in full.
| Parameter | Type | Description |
|---|---|---|
| layer | string | A layer id from an earlier answer: that layer in full, alone |
| polygon * | object | A GeoJSON Polygon (WGS84) |
{
"name": "look_in_area",
"title": "Look inside an area",
"description": "List every Biohotspot map layer with data inside a polygon on the sea, with its nearest few items each. Read-only. Give `layer` (an id from the answer) for that layer in full.",
"inputSchema": {
"type": "object",
"required": [
"polygon"
],
"properties": {
"layer": {
"type": "string",
"description": "A layer id from an earlier answer: that layer in full, alone"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
}
}
},
"annotations": {
"title": "Look inside an area",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Check an area against its protection targets: which habitats it holds, how much of each, what is already protected, and how far each habitat is from its target. Give a polygon, or a point and radius_km. Outside Biohotspot's local planning data the answer comes from world maps and is marked rough: true. Read-only; nothing is saved.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of the place to look at, WGS84 |
| lon | number | Longitude of the place to look at, WGS84 |
| polygon | object | A GeoJSON Polygon (WGS84) |
| radius_km | number |
{
"name": "understand_area",
"title": "Check an area against its targets",
"description": "Check an area against its protection targets: which habitats it holds, how much of each, what is already protected, and how far each habitat is from its target. Give a polygon, or a point and radius_km. Outside Biohotspot's local planning data the answer comes from world maps and is marked rough: true. Read-only; nothing is saved.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the place to look at, WGS84"
},
"lon": {
"type": "number",
"description": "Longitude of the place to look at, WGS84"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
},
"radius_km": {
"type": "number"
}
}
},
"annotations": {
"title": "Check an area against its targets",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Run the Marxan optimiser on Biohotspot's planning data (Exmouth Gulf, Western Australia, for now): the cheapest set of planning squares that meets every habitat target. `polygon` protects the squares mostly inside it (unless `protect` is given); the other settings change targets, compactness and what stays open. Takes a few seconds; returns the summary, each habitat's result and the best solution. Nothing is saved: use save_scenario and run_scenario to keep a run in a project.
| Parameter | Type | Description |
|---|---|---|
| blm | number | Boundary length modifier: higher gives more compact reserves (default 1000) |
| reps | integer | Runs, 1-20 (default 5) |
| polygon | object | A GeoJSON Polygon (WGS84) |
| protect | array | Planning-square ids always included (understand_area returns an area's as `pus`) |
| leave_open | array | Planning-square ids never included |
| target_pct | number | One target for every habitat, in % of its total (instead of the standard targets) |
| target_scale | number | Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half) |
| area_target_pct | number | Also cover this % of the planning area |
{
"name": "simulate",
"title": "Run the protection options (Marxan)",
"description": "Run the Marxan optimiser on Biohotspot's planning data (Exmouth Gulf, Western Australia, for now): the cheapest set of planning squares that meets every habitat target. `polygon` protects the squares mostly inside it (unless `protect` is given); the other settings change targets, compactness and what stays open. Takes a few seconds; returns the summary, each habitat's result and the best solution. Nothing is saved: use save_scenario and run_scenario to keep a run in a project.",
"inputSchema": {
"type": "object",
"properties": {
"blm": {
"type": "number",
"description": "Boundary length modifier: higher gives more compact reserves (default 1000)"
},
"reps": {
"type": "integer",
"description": "Runs, 1-20 (default 5)"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
},
"protect": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids always included (understand_area returns an area's as `pus`)"
},
"leave_open": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids never included"
},
"target_pct": {
"type": "number",
"description": "One target for every habitat, in % of its total (instead of the standard targets)"
},
"target_scale": {
"type": "number",
"description": "Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half)"
},
"area_target_pct": {
"type": "number",
"description": "Also cover this % of the planning area"
}
}
},
"annotations": {
"title": "Run the protection options (Marxan)",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the scenarios saved by you and by the teams of your projects (or one project's, with project_id): name, project, who saved it and its last run's headline numbers. Read-only.
| Parameter | Type | Description |
|---|---|---|
| project_id | integer |
{
"name": "list_scenarios",
"title": "List your scenarios",
"description": "List the scenarios saved by you and by the teams of your projects (or one project's, with project_id): name, project, who saved it and its last run's headline numbers. Read-only.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "List your scenarios",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Save a scenario in one of your projects, where its team sees it on the website: a name, an area (a GeoJSON polygon, optional) and Marxan settings that run_scenario then uses. Side effect: adds a scenario; nothing is overwritten or deleted. Needs a verified sign-in and a place on the project's team.
| Parameter | Type | Description |
|---|---|---|
| blm | number | Boundary length modifier: higher gives more compact reserves (default 1000) |
| name * | string | |
| reps | integer | Runs, 1-20 (default 5) |
| polygon | object | A GeoJSON Polygon (WGS84) |
| protect | array | Planning-square ids always included (understand_area returns an area's as `pus`) |
| leave_open | array | Planning-square ids never included |
| project_id | integer | |
| target_pct | number | One target for every habitat, in % of its total (instead of the standard targets) |
| description | string | |
| target_scale | number | Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half) |
| area_target_pct | number | Also cover this % of the planning area |
{
"name": "save_scenario",
"title": "Save a scenario",
"description": "Save a scenario in one of your projects, where its team sees it on the website: a name, an area (a GeoJSON polygon, optional) and Marxan settings that run_scenario then uses. Side effect: adds a scenario; nothing is overwritten or deleted. Needs a verified sign-in and a place on the project's team.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"blm": {
"type": "number",
"description": "Boundary length modifier: higher gives more compact reserves (default 1000)"
},
"name": {
"type": "string"
},
"reps": {
"type": "integer",
"description": "Runs, 1-20 (default 5)"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
},
"protect": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids always included (understand_area returns an area's as `pus`)"
},
"leave_open": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids never included"
},
"project_id": {
"type": "integer"
},
"target_pct": {
"type": "number",
"description": "One target for every habitat, in % of its total (instead of the standard targets)"
},
"description": {
"type": "string"
},
"target_scale": {
"type": "number",
"description": "Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half)"
},
"area_target_pct": {
"type": "number",
"description": "Also cover this % of the planning area"
}
}
},
"annotations": {
"title": "Save a scenario",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Run Marxan for one of your saved scenarios with its saved settings (any setting given here replaces the saved one for this run) and keep the run with the scenario, as the website does. Takes a few seconds to a minute; returns the run's summary and each habitat's result. Side effect: adds a run; nothing is overwritten. Only the person who saved the scenario can run it.
| Parameter | Type | Description |
|---|---|---|
| blm | number | Boundary length modifier: higher gives more compact reserves (default 1000) |
| reps | integer | Runs, 1-20 (default 5) |
| protect | array | Planning-square ids always included (understand_area returns an area's as `pus`) |
| leave_open | array | Planning-square ids never included |
| target_pct | number | One target for every habitat, in % of its total (instead of the standard targets) |
| scenario_id * | integer | |
| target_scale | number | Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half) |
| area_target_pct | number | Also cover this % of the planning area |
{
"name": "run_scenario",
"title": "Run a saved scenario (Marxan)",
"description": "Run Marxan for one of your saved scenarios with its saved settings (any setting given here replaces the saved one for this run) and keep the run with the scenario, as the website does. Takes a few seconds to a minute; returns the run's summary and each habitat's result. Side effect: adds a run; nothing is overwritten. Only the person who saved the scenario can run it.",
"inputSchema": {
"type": "object",
"required": [
"scenario_id"
],
"properties": {
"blm": {
"type": "number",
"description": "Boundary length modifier: higher gives more compact reserves (default 1000)"
},
"reps": {
"type": "integer",
"description": "Runs, 1-20 (default 5)"
},
"protect": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids always included (understand_area returns an area's as `pus`)"
},
"leave_open": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Planning-square ids never included"
},
"target_pct": {
"type": "number",
"description": "One target for every habitat, in % of its total (instead of the standard targets)"
},
"scenario_id": {
"type": "integer"
},
"target_scale": {
"type": "number",
"description": "Multiply the standard habitat targets, 0-20 (default 1; 0.5 = half)"
},
"area_target_pct": {
"type": "number",
"description": "Also cover this % of the planning area"
}
}
},
"annotations": {
"title": "Run a saved scenario (Marxan)",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Permanently delete one of your own saved scenarios and the runs kept with it, as the website's delete does. It cannot be undone. Only the person who saved a scenario can delete it; projects and their data cannot be deleted with these tools. Tell the user the scenario's name and ask them to confirm before calling it.
| Parameter | Type | Description |
|---|---|---|
| scenario_id * | integer |
{
"name": "delete_scenario",
"title": "Delete a scenario",
"description": "Permanently delete one of your own saved scenarios and the runs kept with it, as the website's delete does. It cannot be undone. Only the person who saved a scenario can delete it; projects and their data cannot be deleted with these tools. Tell the user the scenario's name and ask them to confirm before calling it.",
"inputSchema": {
"type": "object",
"required": [
"scenario_id"
],
"properties": {
"scenario_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Delete a scenario",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Compare a scenario's kept runs (up to 50, newest first): for each, the targets met, area and cost of the best solution and its settings, ranked best first (most targets met, then lowest cost, then smallest area), with why each other run ranks lower. Read-only.
| Parameter | Type | Description |
|---|---|---|
| scenario_id * | integer |
{
"name": "compare_runs",
"title": "Compare a scenario's runs",
"description": "Compare a scenario's kept runs (up to 50, newest first): for each, the targets met, area and cost of the best solution and its settings, ranked best first (most targets met, then lowest cost, then smallest area), with why each other run ranks lower. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"scenario_id"
],
"properties": {
"scenario_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Compare a scenario's runs",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Find Biohotspot map layers by words (e.g. 'seagrass', 'coral bleaching') among its 1,600+ world layers. Returns ids, names and categories (25 by default), and whether each can be read with get_features: only layers whose licence lets Biohotspot share their features are (the others still show in look_here and look_in_area). Also finds the Exmouth Gulf example project's open layers (exmouth_…). Read-only.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string |
{
"name": "find_layers",
"title": "Find map layers",
"description": "Find Biohotspot map layers by words (e.g. 'seagrass', 'coral bleaching') among its 1,600+ world layers. Returns ids, names and categories (25 by default), and whether each can be read with get_features: only layers whose licence lets Biohotspot share their features are (the others still show in look_here and look_in_area). Also finds the Exmouth Gulf example project's open layers (exmouth_…). Read-only.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer"
},
"query": {
"type": "string"
}
}
},
"annotations": {
"title": "Find map layers",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get a vector layer's features as GeoJSON from Biohotspot's OGC API, optionally inside a bounding box [west, south, east, north]; up to `limit` features (500 by default, 5,000 at most). Give an id that find_layers marks get_features: true. Read-only.
| Parameter | Type | Description |
|---|---|---|
| bbox | array | |
| limit | integer | |
| collection * | string |
{
"name": "get_features",
"title": "Read a layer's features",
"description": "Get a vector layer's features as GeoJSON from Biohotspot's OGC API, optionally inside a bounding box [west, south, east, north]; up to `limit` features (500 by default, 5,000 at most). Give an id that find_layers marks get_features: true. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"collection"
],
"properties": {
"bbox": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4
},
"limit": {
"type": "integer"
},
"collection": {
"type": "string"
}
}
},
"annotations": {
"title": "Read a layer's features",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get the facts about an Australian marine park from its Biohotspot page: area, IUCN categories and named zones (CAPAD 2024), habitats, blue carbon and pressures measured inside it, each with its source and licence, and the page's address. Give part of the park's name; `state` (wa, qld, nsw, vic, sa, tas, nt, com for Commonwealth waters) narrows it. Several matches return the list to choose from; parks under 10 km² or without enough open data have no page. Read-only.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Park name or part of it, e.g. 'Ningaloo' |
| state | string |
{
"name": "get_marine_park",
"title": "Australian marine park facts",
"description": "Get the facts about an Australian marine park from its Biohotspot page: area, IUCN categories and named zones (CAPAD 2024), habitats, blue carbon and pressures measured inside it, each with its source and licence, and the page's address. Give part of the park's name; `state` (wa, qld, nsw, vic, sa, tas, nt, com for Commonwealth waters) narrows it. Several matches return the list to choose from; parks under 10 km² or without enough open data have no page. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Park name or part of it, e.g. 'Ningaloo'"
},
"state": {
"type": "string"
}
}
},
"annotations": {
"title": "Australian marine park facts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Search Biohotspot's research library (more than 5,200 papers and reports on coasts and marine habitats) for the words; returns titles, years and DOI links where known (10 by default, 50 at most). Read-only.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string |
{
"name": "search_papers",
"title": "Search the research library",
"description": "Search Biohotspot's research library (more than 5,200 papers and reports on coasts and marine habitats) for the words; returns titles, years and DOI links where known (10 by default, 50 at most). Read-only.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer"
},
"query": {
"type": "string"
}
}
},
"annotations": {
"title": "Search the research library",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List your Biohotspot projects and the ones shared with you: name, area, your role and how complete their data is. Read-only.
No parameters.
{
"name": "list_projects",
"title": "List your projects",
"description": "List your Biohotspot projects and the ones shared with you: name, area, your role and how complete their data is. Read-only.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List your projects",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get one of your projects: its area's bounding box and size, its data check (each data type covered, partial or missing, with the best layer found) and your role. full=true adds the boundary as GeoJSON and every layer found. Read-only.
| Parameter | Type | Description |
|---|---|---|
| full | boolean | |
| project_id * | integer |
{
"name": "get_project",
"title": "Read a project",
"description": "Get one of your projects: its area's bounding box and size, its data check (each data type covered, partial or missing, with the best layer found) and your role. full=true adds the boundary as GeoJSON and every layer found. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"full": {
"type": "boolean"
},
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Read a project",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the data a project's team added, with each file's status (receiving, checked, ready, failed). Read-only.
| Parameter | Type | Description |
|---|---|---|
| project_id * | integer |
{
"name": "list_project_data",
"title": "Read a project's data",
"description": "List the data a project's team added, with each file's status (receiving, checked, ready, failed). Read-only.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Read a project's data",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Add data to a project from a public download link (GeoPackage, zipped Shapefile, GeoJSON, KML, CSV with coordinates or GeoTIFF, up to 200 MB): your own model's output, a survey, a map. Side effect: the file is downloaded, stored and added to the project, where its team can see it; nothing is deleted or overwritten. Biohotspot then checks it; follow its status with list_project_data and finish anything it asks for in the project's Uploads tab. Needs owner or editor rights.
| Parameter | Type | Description |
|---|---|---|
| url * | string | |
| year | integer | |
| title | string | |
| source | string | Who made it |
| licence | string | cc-by, cc0, cc-by-nc, other-open, restricted or unsure |
| project_id * | integer |
{
"name": "add_project_data",
"title": "Add data to a project",
"description": "Add data to a project from a public download link (GeoPackage, zipped Shapefile, GeoJSON, KML, CSV with coordinates or GeoTIFF, up to 200 MB): your own model's output, a survey, a map. Side effect: the file is downloaded, stored and added to the project, where its team can see it; nothing is deleted or overwritten. Biohotspot then checks it; follow its status with list_project_data and finish anything it asks for in the project's Uploads tab. Needs owner or editor rights.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"url"
],
"properties": {
"url": {
"type": "string"
},
"year": {
"type": "integer"
},
"title": {
"type": "string"
},
"source": {
"type": "string",
"description": "Who made it"
},
"licence": {
"type": "string",
"description": "cc-by, cc0, cc-by-nc, other-open, restricted or unsure"
},
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Add data to a project",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}What a project team's own data (their accepted uploads) holds at a point on the sea within `km` (default 1), or inside a polygon: per upload, how many features are there and a few of their names, or a grid's value at the point. Only the data you may see on that project. Read-only.
| Parameter | Type | Description |
|---|---|---|
| km | number | |
| lat | number | Latitude of the place to look at, WGS84 |
| lon | number | Longitude of the place to look at, WGS84 |
| polygon | object | A GeoJSON Polygon (WGS84) |
| project_id * | integer |
{
"name": "look_in_project_data",
"title": "Look in a project's own data",
"description": "What a project team's own data (their accepted uploads) holds at a point on the sea within `km` (default 1), or inside a polygon: per upload, how many features are there and a few of their names, or a grid's value at the point. Only the data you may see on that project. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"km": {
"type": "number"
},
"lat": {
"type": "number",
"description": "Latitude of the place to look at, WGS84"
},
"lon": {
"type": "number",
"description": "Longitude of the place to look at, WGS84"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
},
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Look in a project's own data",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the habitats Biohotspot measures across Australia's marine parks (mangroves, the modelled kelp forest biome and tidal marshes, for now): each one's id, name, how many parks hold it and whether it has a page. Read-only.
No parameters.
{
"name": "list_habitats",
"title": "List the habitats",
"description": "List the habitats Biohotspot measures across Australia's marine parks (mangroves, the modelled kelp forest biome and tidal marshes, for now): each one's id, name, how many parks hold it and whether it has a page. Read-only.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List the habitats",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get one habitat across Australia's marine parks, as its Biohotspot page shows it: the parks that hold it with their figures, sources and the page's address. Give its id from list_habitats or part of its name. Read-only.
| Parameter | Type | Description |
|---|---|---|
| habitat * | string | Habitat id or name, e.g. 'seagrass' |
{
"name": "get_habitat",
"title": "A habitat across marine parks",
"description": "Get one habitat across Australia's marine parks, as its Biohotspot page shows it: the parks that hold it with their figures, sources and the page's address. Give its id from list_habitats or part of its name. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"habitat"
],
"properties": {
"habitat": {
"type": "string",
"description": "Habitat id or name, e.g. 'seagrass'"
}
}
},
"annotations": {
"title": "A habitat across marine parks",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}How many features of a world map layer fall in each year (for layers with dates, such as sightings or bleaching surveys): the series the map's year slider draws. Give a find_layers id. Read-only.
| Parameter | Type | Description |
|---|---|---|
| layer * | string |
{
"name": "get_layer_years",
"title": "A layer's features by year",
"description": "How many features of a world map layer fall in each year (for layers with dates, such as sightings or bleaching surveys): the series the map's year slider draws. Give a find_layers id. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"layer"
],
"properties": {
"layer": {
"type": "string"
}
}
},
"annotations": {
"title": "A layer's features by year",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read a research library document's text, page by page (pages `from_page` to `to_page`, at most 30 at once; default the first 5). Give a document id from search_papers. Documents without a PDF in the library have no pages. Read-only.
| Parameter | Type | Description |
|---|---|---|
| to_page | integer | |
| from_page | integer | |
| document_id * | integer |
{
"name": "read_paper",
"title": "Read a library document",
"description": "Read a research library document's text, page by page (pages `from_page` to `to_page`, at most 30 at once; default the first 5). Give a document id from search_papers. Documents without a PDF in the library have no pages. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"document_id"
],
"properties": {
"to_page": {
"type": "integer"
},
"from_page": {
"type": "integer"
},
"document_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Read a library document",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List Biohotspot's public projects, the worked examples first: name, area and how complete their data is, and whether each is already in your list. Read-only.
No parameters.
{
"name": "list_public_projects",
"title": "List the public projects",
"description": "List Biohotspot's public projects, the worked examples first: name, area and how complete their data is, and whether each is already in your list. Read-only.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List the public projects",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a Biohotspot project of yours for an area on the sea: a name and a GeoJSON polygon. Biohotspot then runs its data check (what data covers the area). Side effect: adds a project you own; nothing else changes. Needs a verified sign-in.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| polygon * | object | A GeoJSON Polygon (WGS84) |
{
"name": "create_project",
"title": "Create a project",
"description": "Create a Biohotspot project of yours for an area on the sea: a name and a GeoJSON polygon. Biohotspot then runs its data check (what data covers the area). Side effect: adds a project you own; nothing else changes. Needs a verified sign-in.",
"inputSchema": {
"type": "object",
"required": [
"name",
"polygon"
],
"properties": {
"name": {
"type": "string"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
}
}
},
"annotations": {
"title": "Create a project",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Rename one of your projects or replace its area (a GeoJSON polygon; the data check runs again). Overwrites the old name or area. Needs owner or editor rights; who can see the project is changed on the website only.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| polygon | object | A GeoJSON Polygon (WGS84) |
| project_id * | integer |
{
"name": "update_project",
"title": "Rename or redraw a project",
"description": "Rename one of your projects or replace its area (a GeoJSON polygon; the data check runs again). Overwrites the old name or area. Needs owner or editor rights; who can see the project is changed on the website only.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"name": {
"type": "string"
},
"polygon": {
"type": "object",
"description": "A GeoJSON Polygon (WGS84)"
},
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Rename or redraw a project",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Finish a file added to a project (list_project_data shows those waiting): say what it is (title, source, year, licence: cc-by, cc0, cc-by-nc, other-open, restricted or unsure; item = the data-check item it fills), match its columns (`mapping`, {field: column}, e.g. {"scientificName": "species"}), run Biohotspot's checks and, unless accept is false, use it so it shows on the map and counts in the data check. What is not given keeps its current value. Returns the check's verdict. Needs owner or editor rights.
| Parameter | Type | Description |
|---|---|---|
| item | string | |
| year | integer | |
| title | string | |
| accept | boolean | Use it once the checks pass (default true) |
| source | string | |
| licence | string | |
| mapping | object | |
| upload_id * | integer |
{
"name": "finish_upload",
"title": "Finish an upload",
"description": "Finish a file added to a project (list_project_data shows those waiting): say what it is (title, source, year, licence: cc-by, cc0, cc-by-nc, other-open, restricted or unsure; item = the data-check item it fills), match its columns (`mapping`, {field: column}, e.g. {\"scientificName\": \"species\"}), run Biohotspot's checks and, unless accept is false, use it so it shows on the map and counts in the data check. What is not given keeps its current value. Returns the check's verdict. Needs owner or editor rights.",
"inputSchema": {
"type": "object",
"required": [
"upload_id"
],
"properties": {
"item": {
"type": "string"
},
"year": {
"type": "integer"
},
"title": {
"type": "string"
},
"accept": {
"type": "boolean",
"description": "Use it once the checks pass (default true)"
},
"source": {
"type": "string"
},
"licence": {
"type": "string"
},
"mapping": {
"type": "object"
},
"upload_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Finish an upload",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Add a public project (list_public_projects) to your list, view only, to look at and plan in it. Side effect: it appears in your project list; nothing else changes.
| Parameter | Type | Description |
|---|---|---|
| project_id * | integer |
{
"name": "load_public_project",
"title": "Add a public project to your list",
"description": "Add a public project (list_public_projects) to your list, view only, to look at and plan in it. Side effect: it appears in your project list; nothing else changes.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Add a public project to your list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Take a project off your list: a public project you loaded, or a project shared with you, which you then leave (its team must add you again for you to see its team-only data). Your own projects cannot be removed this way. Ask the user before calling it for a shared project.
| Parameter | Type | Description |
|---|---|---|
| project_id * | integer |
{
"name": "remove_project_from_list",
"title": "Take a project off your list",
"description": "Take a project off your list: a public project you loaded, or a project shared with you, which you then leave (its team must add you again for you to see its team-only data). Your own projects cannot be removed this way. Ask the user before calling it for a shared project.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Take a project off your list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Share one of your projects with a person by email, as an editor or a viewer: Biohotspot emails them a link in your name. Side effect: an email is sent and they join the project's team. Only adds people: someone already on the team keeps their role (change roles on the website). Needs owner or editor rights. Confirm the address with the user first.
| Parameter | Type | Description |
|---|---|---|
| role | string | Default viewer |
| email * | string | |
| project_id * | integer |
{
"name": "share_project",
"title": "Share a project",
"description": "Share one of your projects with a person by email, as an editor or a viewer: Biohotspot emails them a link in your name. Side effect: an email is sent and they join the project's team. Only adds people: someone already on the team keeps their role (change roles on the website). Needs owner or editor rights. Confirm the address with the user first.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"email"
],
"properties": {
"role": {
"enum": [
"viewer",
"editor"
],
"type": "string",
"description": "Default viewer"
},
"email": {
"type": "string"
},
"project_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Share a project",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Make a PDF report and get a link to it, good for a day: give project_id for the project's data report (what data covers the area, what is missing, the team's files and scenarios) or scenario_id for a scenario report (its habitats against their targets, its kept Marxan runs compared, the best run habitat by habitat). The PDF is built when the link is opened, for the person who asked. Read-only.
| Parameter | Type | Description |
|---|---|---|
| project_id | integer | |
| scenario_id | integer |
{
"name": "make_report",
"title": "Make a PDF report",
"description": "Make a PDF report and get a link to it, good for a day: give project_id for the project's data report (what data covers the area, what is missing, the team's files and scenarios) or scenario_id for a scenario report (its habitats against their targets, its kept Marxan runs compared, the best run habitat by habitat). The PDF is built when the link is opened, for the person who asked. Read-only.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "integer"
},
"scenario_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Make a PDF report",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Email a scenario's PDF report to up to 10 people with a link to the scenario, in your name (replies reach you), as the website's Share report does. Side effect: an email is sent. Confirm the addresses with the user first.
| Parameter | Type | Description |
|---|---|---|
| to * | array | |
| message | string | A short note, up to 500 characters |
| scenario_id * | integer |
{
"name": "email_report",
"title": "Email a scenario report",
"description": "Email a scenario's PDF report to up to 10 people with a link to the scenario, in your name (replies reach you), as the website's Share report does. Side effect: an email is sent. Confirm the addresses with the user first.",
"inputSchema": {
"type": "object",
"required": [
"scenario_id",
"to"
],
"properties": {
"to": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"message": {
"type": "string",
"description": "A short note, up to 500 characters"
},
"scenario_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Email a scenario report",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Biohotspot: ocean data for any coast or sea, and marine protection planning. Look at a place (look_here), understand an area's habitats against their targets (understand_area), simulate protection options (simulate; planning data covers Exmouth Gulf for now), find layers and their features, get an Australian marine park's facts (get_marine_park), search papers, and work with the signed-in user's projects and scenarios. Tools marked readOnlyHint false change the user's data, each only as the website lets that user: add data, finish uploads, save and run scenarios, create, rename or redraw a project, add a public project to their list or take one off, share a project and email a scenario report, both of which email people in the user's name, and delete one of their own scenarios. Confirm with the user before emailing anyone, leaving a shared project or deleting a scenario. make_report gives a link to a PDF report of a project or a scenario. Only delete_scenario deletes, and only the user's own scenarios: no tool deletes a project or data.
Names, descriptions and schemas were written by the server and are shown as data.