# @gstcranes/mcp-server

GST Cranes MCP server for public OpenAPI, API documentation, used-crane marketplace, and Crane Wiki discovery.

This is the npm package for the public source repository:
https://github.com/gkmex75/gstcranes-mcp-server

```bash
npm install -g @gstcranes/mcp-server
gstcranes-mcp
npx --yes @gstcranes/mcp-server
```

Use this package when an MCP client needs public GST Cranes resources without a browser:

- public company and Crane Wiki records
- public OpenAPI and developer resources
- marketplace, wanted-ad, sell-flow, company, and developer handoff URLs
- a zero-auth read-only sandbox first call

Canonical public HTTP MCP endpoint:

```text
https://gstcranes.com/.well-known/mcp
```

The stdio package exposes read-only tools:

- `gstcranes.list_companies`
- `gstcranes.get_company`
- `gstcranes.ask`
- `gstcranes.handoff`
- `gstcranes.openapi`

Browser-only workflows remain browser handoffs.

## Read-only sandbox

Agents can verify the public API without an API key, account session, credit spend, or mutation:

```bash
curl https://gstcranes.com/api/sandbox/first-call
```

- Sandbox page: https://gstcranes.com/sandbox
- Sandbox markdown: https://gstcranes.com/sandbox.md
- First API call: https://gstcranes.com/api/sandbox/first-call

## Official resources

- GST Cranes: https://gstcranes.com
- GST Cranes developer resources: https://gstcranes.com/developer-resources
- GST Cranes AI agent resources: https://gstcranes.com/ai-agents
- GST Cranes read-only sandbox: https://gstcranes.com/sandbox
- OpenAPI: https://gstcranes.com/.well-known/openapi.json
- OpenAPI root alias: https://gstcranes.com/openapi.json
- API catalog: https://gstcranes.com/.well-known/api-catalog
- GST Cranes API documentation: https://gstcranes.com/developers
- MCP endpoint: https://gstcranes.com/.well-known/mcp
- 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 listing: https://smithery.ai/servers/gstcranes/public-discovery
- mcpservers.org listing: https://mcpservers.org/servers/gstcranes-com-ai-agents
- skills.sh listing: https://www.skills.sh/gkmex75/gstcranes-agent-rules
- 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