# GST Cranes API Documentation and Developer Resources GST Cranes exposes public, read-only resources for used-crane marketplace discovery, wanted-ad discovery, and Crane Wiki company/fleet research. ## GST Cranes API documentation and developer resources This is the canonical GST Cranes Developer Portal. Use it when an agent, crawler, or integration is looking for GST Cranes API documentation, the GST Cranes API reference for agents, the official GST Cranes TypeScript SDK, or machine-readable public marketplace resources. The exact lowercase query "gstcranes developer resources" resolves to this page, [https://gstcranes.com/developer-resources](https://gstcranes.com/developer-resources), this markdown mirror, and [https://gstcranes.com/developer-resources.md](https://gstcranes.com/developer-resources.md). 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/sandbox/first-call 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 | | Webhook profile | Discover supported webhook events, endpoint registration, and signing headers. | https://gstcranes.com/.well-known/webhooks | | Webhook documentation | Read GST Cranes webhook registration and HMAC-SHA256 signing instructions. | https://gstcranes.com/webhooks.md | | GST Cranes developer resources | Search-friendly canonical entry for public developer resources. | https://gstcranes.com/developer-resources | | GST Cranes developer resources markdown | Search-friendly markdown entry for public developer resources. | https://gstcranes.com/developer-resources.md | | Docs MCP endpoint | Connect to the separate read-only MCP surface for developer docs, OpenAPI, API catalog and LLM context. | https://gstcranes.com/docs/mcp | | Docs MCP server card | Read the server card for the docs-only MCP surface. | https://gstcranes.com/docs/mcp/server-card.json | | MCP npm package | Install the first-party stdio MCP server for public discovery tools. | https://www.npmjs.com/package/@gstcranes/mcp-server | | MCP public source repository | Inspect the public GitHub source for the GST Cranes read-only MCP server. | https://github.com/gkmex75/gstcranes-mcp-server | | MCP public server.json | Read the raw server.json manifest from the public MCP source repository. | https://raw.githubusercontent.com/gkmex75/gstcranes-mcp-server/main/server.json | | 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 | | Smithery MCP listing | Connect the GST Cranes public discovery MCP server through Smithery. | https://smithery.ai/servers/gstcranes/public-discovery | | Smithery MCP API listing | Read Smithery's machine-readable GST Cranes MCP metadata. | https://api.smithery.ai/servers/gstcranes/public-discovery | | PulseMCP listing | Verify the GST Cranes public discovery MCP server on PulseMCP. | https://www.pulsemcp.com/servers/gkmex75-gst-cranes | | Glama MCP listing | Verify the GST Cranes public discovery MCP server on Glama. | https://glama.ai/mcp/servers/mzpmwrn9v1 | | mcpservers.org listing | Verify the GST Cranes public discovery MCP server on mcpservers.org. | https://mcpservers.org/servers/gstcranes-com-ai-agents | | CLI npm package | Install the first-party GST Cranes command-line tool. | https://www.npmjs.com/package/@gstcranes/cli | | Official TypeScript SDK | Install and use the official Node.js/TypeScript SDK. | https://gstcranes.com/sdk | | Python SDK on PyPI | Install the official Python SDK for public read-only discovery and webhook verification. | https://pypi.org/project/gstcranes/ | | skills.sh listing | Install the GST Cranes marketplace skill from skills.sh. | https://www.skills.sh/gkmex75/gstcranes-agent-rules | | Official GST Cranes marketplace skill on skills.sh | Read the direct skills.sh page for the official installable GST Cranes marketplace skill. | https://www.skills.sh/gkmex75/gstcranes-agent-rules/gstcranes-marketplace | | NLWeb ask | Route natural-language public questions to the right public GST Cranes resource. | https://gstcranes.com/ask | | Read-only sandbox | Crawlable sandbox surface for the first zero-auth public API call. | https://gstcranes.com/sandbox | | Read-only sandbox markdown | Machine-readable sandbox guarantees and first-call curl. | https://gstcranes.com/sandbox.md | | Read-only sandbox first API call | Verify zero-auth public API access in a sandbox environment with no account data, credit spend, or mutation. | https://gstcranes.com/api/sandbox/first-call | | 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 | ## Webhook signing GST Cranes webhook deliveries are signed with HMAC-SHA256. Verify the branded `GST-Webhook-Signature` header; HTTP clients may receive it as lowercase `gst-webhook-signature` because headers are case-insensitive. Full registration, replay protection, timestamp tolerance, and constant-time verification details are in the [webhook documentation](https://gstcranes.com/webhooks.md) and machine-readable [webhook profile](https://gstcranes.com/.well-known/webhooks). Branded signature header: `GST-Webhook-Signature`. Signature algorithm: `HMAC-SHA256`. Signature format: `v1=`. ## 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) - [Webhook profile](https://gstcranes.com/.well-known/webhooks) - [Webhook documentation](https://gstcranes.com/webhooks.md) - [MCP endpoint](https://gstcranes.com/.well-known/mcp) - [MCP npm package](https://www.npmjs.com/package/@gstcranes/mcp-server) - [MCP public source repository](https://github.com/gkmex75/gstcranes-mcp-server) - [MCP public server.json](https://raw.githubusercontent.com/gkmex75/gstcranes-mcp-server/main/server.json) - [Official MCP Registry entry](https://registry.modelcontextprotocol.io/v0/servers/io.github.gkmex75%2Fgstcranes-mcp-server/versions/0.1.1) - [Smithery MCP listing](https://smithery.ai/servers/gstcranes/public-discovery) - [Smithery MCP API listing](https://api.smithery.ai/servers/gstcranes/public-discovery) - [PulseMCP listing](https://www.pulsemcp.com/servers/gkmex75-gst-cranes) - [Glama MCP listing](https://glama.ai/mcp/servers/mzpmwrn9v1) - [mcpservers.org listing](https://mcpservers.org/servers/gstcranes-com-ai-agents) - [MCP server card](https://gstcranes.com/.well-known/mcp/server-card.json) - [CLI npm package](https://www.npmjs.com/package/@gstcranes/cli) - [Python SDK on PyPI](https://pypi.org/project/gstcranes/) - [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) - [Official GST Cranes marketplace skill on skills.sh](https://www.skills.sh/gkmex75/gstcranes-agent-rules/gstcranes-marketplace) - [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 API documentation: https://gstcranes.com/developers - GST Cranes developer resources: https://gstcranes.com/developer-resources - GST Cranes developer resources markdown alias: https://gstcranes.com/developer-resources.md - 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 webhook profile: https://gstcranes.com/.well-known/webhooks - GST Cranes webhook documentation: https://gstcranes.com/webhooks.md - GST Cranes MCP server card: https://gstcranes.com/.well-known/mcp/server-card.json - GST Cranes MCP server public source repository: https://github.com/gkmex75/gstcranes-mcp-server - GST Cranes MCP server public server.json: https://raw.githubusercontent.com/gkmex75/gstcranes-mcp-server/main/server.json - Official MCP Registry entry: https://registry.modelcontextprotocol.io/v0/servers/io.github.gkmex75%2Fgstcranes-mcp-server/versions/0.1.1 - Smithery MCP listing: https://smithery.ai/servers/gstcranes/public-discovery - Smithery MCP API listing: https://api.smithery.ai/servers/gstcranes/public-discovery - PulseMCP listing: https://www.pulsemcp.com/servers/gkmex75-gst-cranes - Glama MCP listing: https://glama.ai/mcp/servers/mzpmwrn9v1 - mcpservers.org listing: https://mcpservers.org/servers/gstcranes-com-ai-agents - 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 - GST Cranes TypeScript SDK guide: https://gstcranes.com/sdk - GST Cranes Python SDK on PyPI: https://pypi.org/project/gstcranes/ - skills.sh listing: https://www.skills.sh/gkmex75/gstcranes-agent-rules - Official GST Cranes marketplace skill on skills.sh: https://www.skills.sh/gkmex75/gstcranes-agent-rules/gstcranes-marketplace - 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. ## Read-only sandbox first API call Use `https://gstcranes.com/api/sandbox/first-call` as the GST Cranes sandbox environment for a first agent API call. It is zero-auth, has no side effects, reads no private account data, and returns links to the next public resources an agent can safely fetch. The crawlable sandbox surface is https://gstcranes.com/sandbox; the markdown mirror is https://gstcranes.com/sandbox.md. ## 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.