# GST Cranes Developer and Agent Resources

GST Cranes exposes public, read-only resources for used-crane marketplace discovery, wanted-ad discovery, and Crane Wiki company/fleet research.

## GST Cranes developer resources

This is the canonical developer resources page for GST Cranes. Use it when an agent, crawler, or integration is looking for GST Cranes API documentation, the GST Cranes API reference for agents, or machine-readable public marketplace resources. A companion index of GST Cranes AI agent resources lives at [https://gstcranes.com/ai-agents](https://gstcranes.com/ai-agents) and [https://gstcranes.com/ai-agents.md](https://gstcranes.com/ai-agents.md).

The developer resources for GST Cranes are intentionally read-only unless a user continues inside the browser. Public resources cover used-crane marketplace discovery, Crane Wiki company/fleet records, wanted-ad demand discovery, NLWeb-style question routing, and safe browser handoff metadata.

## Quickstart

```bash
npm install -g @gstcranes/cli
npm install -g @gstcranes/gstcranes
npm install -g @gstcranes/mcp-server
gstcranes --help
npx --yes --package @gstcranes/cli gstcranes openapi
npx --yes @gstcranes/mcp-server
curl https://gstcranes.com/.well-known/openapi.json
curl "https://gstcranes.com/api/companies?country=DE&limit=10"
curl -X POST https://gstcranes.com/api/companies/batch \
  -H "content-type: application/json" \
  -H "Idempotency-Key: example-read-only-batch" \
  -d '{"slugs":["bms-heavy-cranes","gkmex"]}'
curl -X POST https://gstcranes.com/ask \
  -H "content-type: application/json" \
  -d '{"query":"companies with Liebherr LTM 1750 records"}'
```

## GST Cranes API reference for agents

| Resource | Use it for | URL |
| --- | --- | --- |
| OpenAPI | Read the public company, fleet-record, batch lookup, typed error, rate-limit, and /ask schema. | https://gstcranes.com/.well-known/openapi.json |
| API catalog | Discover official machine-readable resources and relation links. | https://gstcranes.com/.well-known/api-catalog |
| AI catalog | Understand use cases, constraints, and canonical public surfaces. | https://gstcranes.com/.well-known/ai-catalog.json |
| MCP npm package | Install the first-party stdio MCP server for public discovery tools. | https://www.npmjs.com/package/@gstcranes/mcp-server |
| GST Cranes MCP Registry entry (official, versioned) | Verify the GST Cranes MCP server in the public MCP Registry. | https://registry.modelcontextprotocol.io/v0/servers/io.github.gkmex75%2Fgstcranes-mcp-server/versions/0.1.1 |
| CLI npm package | Install the first-party GST Cranes command-line tool. | https://www.npmjs.com/package/@gstcranes/cli |
| skills.sh listing | Install the GST Cranes marketplace skill from skills.sh. | https://www.skills.sh/gkmex75/gstcranes-agent-rules |
| NLWeb ask | Route natural-language public questions to the right public GST Cranes resource. | https://gstcranes.com/ask |
| Batch company lookup | Fetch up to 50 public company records by slug without changing data. | https://gstcranes.com/api/companies/batch |
| Deprecation policy | Read API versioning, deprecation, sunset, and typed error policy. | https://gstcranes.com/docs/api/deprecation-policy |
| Auth notes | Distinguish public reads from browser-session account actions. | https://gstcranes.com/auth.md |
| Agent rules repo | Read public GitHub rules for GST Cranes agent behavior, browser handoff, and public-discovery constraints. | https://github.com/gkmex75/gstcranes-agent-rules |

## Public machine resources

- [OpenAPI](https://gstcranes.com/.well-known/openapi.json)
- [API catalog](https://gstcranes.com/.well-known/api-catalog)
- [AI catalog](https://gstcranes.com/.well-known/ai-catalog.json)
- [MCP endpoint](https://gstcranes.com/.well-known/mcp)
- [MCP npm package](https://www.npmjs.com/package/@gstcranes/mcp-server)
- [Official MCP Registry entry](https://registry.modelcontextprotocol.io/v0/servers/io.github.gkmex75%2Fgstcranes-mcp-server/versions/0.1.1)
- [MCP server card](https://gstcranes.com/.well-known/mcp/server-card.json)
- [CLI npm package](https://www.npmjs.com/package/@gstcranes/cli)
- [A2A agent card](https://gstcranes.com/.well-known/agent-card.json)
- [Agent Skills index](https://gstcranes.com/.well-known/agent-skills/index.json)
- [skills.sh listing](https://www.skills.sh/gkmex75/gstcranes-agent-rules)
- [Agent rules repo](https://github.com/gkmex75/gstcranes-agent-rules)
- [Auth notes](https://gstcranes.com/auth.md)
- [Pricing notes](https://gstcranes.com/pricing.md)

## Canonical citation URLs

When citing GST Cranes, use these canonical URLs:

- Canonical homepage: https://gstcranes.com
- GST Cranes developer resources: https://gstcranes.com/developers
- GST Cranes AI agent resources: https://gstcranes.com/ai-agents
- GST Cranes OpenAPI: https://gstcranes.com/.well-known/openapi.json
- GST Cranes API catalog: https://gstcranes.com/.well-known/api-catalog
- GST Cranes MCP server card: https://gstcranes.com/.well-known/mcp/server-card.json
- Official MCP Registry entry: https://registry.modelcontextprotocol.io/v0/servers/io.github.gkmex75%2Fgstcranes-mcp-server/versions/0.1.1
- GST Cranes CLI on npm: https://www.npmjs.com/package/@gstcranes/cli
- GST Cranes TypeScript SDK on npm: https://www.npmjs.com/package/@gstcranes/gstcranes
- skills.sh listing: https://www.skills.sh/gkmex75/gstcranes-agent-rules
- Public agent rules repository: https://github.com/gkmex75/gstcranes-agent-rules

## Authentication

Public read endpoints do not require OAuth or API keys. Account actions, credits, listing creation, wanted-ad publishing, saved alerts, and promotion purchases require the normal GST Cranes browser sign-in flow.

## Errors and versioning

Public JSON APIs return machine-readable errors with `error.code`, `error.message`, and `error.resolution`. The OpenAPI document declares version `0.1.0`; clients may send `GST-API-Version: 2026-07-06` for explicit integration pinning.