# 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 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. 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 | | 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 | | 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 | | 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 | | skills.sh listing | Install the GST Cranes marketplace skill from skills.sh. | https://www.skills.sh/gkmex75/gstcranes-agent-rules | | GST Cranes marketplace skill page on skills.sh | Read the direct skills.sh page for the 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 | ## 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) - [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) - [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) - [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) - [GST Cranes marketplace skill page 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 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 - 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 - skills.sh listing: https://www.skills.sh/gkmex75/gstcranes-agent-rules - GST Cranes marketplace skill page 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.