# `nasa__jpl_nhats`

Human-accessible NEOs (Near-Earth Objects) data

- Server: [NASA Open APIs](https://gateway.mcpharbor.dev/docs/servers/nasa) (`dev.mcpharbor.gateway/nasa`)
- Price per call: $0.0001 (100 micro-USD); only tools/call is charged
- Endpoint: `https://gateway.mcpharbor.dev/mcp` or `https://gateway.mcpharbor.dev/mcp/nasa`
- Upstream tool: exposed by the provider; called through this gateway as `nasa__jpl_nhats`
- Provider terms: <https://api.nasa.gov/> (verified 2026-09-19)
- Upstream API documentation: <https://api.nasa.gov/>
- Rate limit: 900 requests per hour
- Attribution required: NASA should be acknowledged as the source of the material

## Parameters

- `des` (string, optional): Object designation (e.g., '2000 SG344' or '433')
- `dur` (number, optional): Minimum total mission duration (days). Values: 60-450, default: 450
- `dv` (number, optional): Minimum total delta-V (km/s). Values: 4-12, default: 12
- `h` (number, optional): Object's maximum absolute magnitude (mag). Values: 16-30
- `launch` (string, optional): Launch window (year range). Values: 2020-2025, 2025-2030, 2030-2035, 2035-2040, 2040-2045, 2020-2045, default: 2020-2045
- `occ` (number, optional): Object's maximum orbit condition code. Values: 0-8
- `plot` (boolean, optional): Include base-64 encoded plot image
- `spk` (string, optional): Object SPK-ID (e.g., '2000433')
- `stay` (number, optional): Minimum stay time (days). Values: 8, 16, 24, 32, default: 8

## Example call

Request headers and body:

```http
POST /mcp HTTP/1.1
Host: gateway.mcpharbor.dev
Authorization: Bearer <your gateway API key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: nasa__jpl_nhats
```

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/clientCapabilities": {},
      "io.modelcontextprotocol/clientInfo": {
        "name": "example-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/protocolVersion": "2026-07-28"
    },
    "arguments": {
      "des": "example"
    },
    "name": "nasa__jpl_nhats"
  }
}
```

A successful response:

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "_meta": {
      "dev.mcpharbor.gateway/call": {
        "chargedMicroUsd": 100,
        "id": "<the id of this charge>"
      }
    },
    "content": [
      {
        "text": "<whatever the upstream tool returned>",
        "type": "text"
      }
    ],
    "resultType": "complete"
  }
}
```

This call costs $0.0001 (100 micro-USD). Reading this page and listing the tool cost nothing.
The `dev.mcpharbor.gateway/call` record in the result is the receipt for that charge. Each
POST is metered separately, so sending the same call again buys another one: see
[agent.txt](https://gateway.mcpharbor.dev/agent.txt), section 7, before retrying.

## Attribution

This provider requires the attribution below wherever you use results from its tools.
Reproduce it verbatim:

> NASA should be acknowledged as the source of the material

## Tool definition

Exactly as `tools/list` returns it (free):

```json
{
  "_meta": {
    "dev.mcpharbor.gateway/pricing": {
      "currency": "USD",
      "pricePerCallMicroUsd": 100
    }
  },
  "description": "Human-accessible NEOs (Near-Earth Objects) data",
  "inputSchema": {
    "properties": {
      "des": {
        "description": "Object designation (e.g., '2000 SG344' or '433')",
        "type": "string"
      },
      "dur": {
        "description": "Minimum total mission duration (days). Values: 60-450, default: 450",
        "type": "number"
      },
      "dv": {
        "description": "Minimum total delta-V (km/s). Values: 4-12, default: 12",
        "type": "number"
      },
      "h": {
        "description": "Object's maximum absolute magnitude (mag). Values: 16-30",
        "type": "number"
      },
      "launch": {
        "description": "Launch window (year range). Values: 2020-2025, 2025-2030, 2030-2035, 2035-2040, 2040-2045, 2020-2045, default: 2020-2045",
        "type": "string"
      },
      "occ": {
        "description": "Object's maximum orbit condition code. Values: 0-8",
        "type": "number"
      },
      "plot": {
        "description": "Include base-64 encoded plot image",
        "type": "boolean"
      },
      "spk": {
        "description": "Object SPK-ID (e.g., '2000433')",
        "type": "string"
      },
      "stay": {
        "description": "Minimum stay time (days). Values: 8, 16, 24, 32, default: 8",
        "type": "number"
      }
    },
    "type": "object"
  },
  "name": "nasa__jpl_nhats"
}
```