Skip to content

Releases: terramate-io/terramate-mcp-server

v0.0.6

19 Feb 11:53
f14d644

Choose a tag to compare

What's Changed

Full Changelog: v0.0.5...v0.0.6

v0.0.5

13 Feb 21:11
0cab5ff

Choose a tag to compare

0.0.5 - 2026-02-13

Added

  • Add self-write guard to prevent redundant credential reloads after the MCP server writes refreshed tokens back to the credential file

Changed

  • Improve log message when credential file write fails after token refresh to clarify this is expected for read-only Docker mounts
  • Improve error message when refresh_token is missing from credential file to guide users toward running terramate cloud login
  • Surface token refresh failure reason in 401 error responses instead of returning a generic authentication error
  • Change generic unauthorized error text to credential-type-agnostic wording (credentials are invalid or expired)

Fixed

  • Fix JWT refresh key mismatch by aligning MCP server default Firebase IDP key with Terramate CLI and supporting TMC_API_IDP_KEY override

v0.0.4

12 Feb 17:29
f31ab40

Choose a tag to compare

What's Changed

New Contributors

Full Changelog: v0.0.3...v0.0.4

0.0.3

10 Dec 23:09
4383b62

Choose a tag to compare

Changelog

Added

  • Add automatic JWT token refresh when API returns 401 Unauthorized
  • Add file watching to automatically reload credentials when Terramate CLI updates them
  • Add thread-safe credential management with mutex protection
  • Add StartWatching() and StopWatching() methods for credential file monitoring
  • Add comprehensive test suite for token refresh and file watching functionality
  • Add test coverage for file watcher stop/restart scenarios

Changed

  • JWT credentials now automatically refresh expired tokens without user intervention
  • MCP server and Terramate CLI can now safely share and update the same credential file
  • Credential file updates are atomic to prevent corruption during concurrent access

Fixed

  • Fix US region endpoint from api.us.terramate.io to us.api.terramate.io
  • Fix potential race condition in waitForRefresh method for improved context cancellation handling

v0.0.2

13 Nov 02:16
e5bd4ec

Choose a tag to compare

v0.0.2

Added

  • Add JWT token authentication support for user-level credentials
  • Add --credential-file flag to specify custom JWT credential file location
  • Add LoadJWTFromFile() function to load credentials from ~/.terramate.d/credentials.tmrc.json
  • Add Credential interface for authentication abstraction
  • Add JWTCredential implementation with automatic expiration checking
  • Add NewClientWithJWT() convenience constructor for JWT-based authentication
  • Add NewClientWithAPIKey() convenience constructor for API key authentication
  • Add comprehensive test coverage for JWT authentication flows
  • Add integration tests for MCP server with JWT credentials
  • Add auto-refresh pattern for JWT tokens in AI assistant configurations (runs terramate cloud info before starting server)

Changed

  • Change NewClient() to accept Credential interface instead of raw API key string
  • Change MCP server to auto-load JWT credentials from default location when no API key provided
  • Update all tests to use new NewClientWithAPIKey() constructor
  • Update Makefile run, dev, and docker/run targets to support both JWT and API key authentication
  • Update Dockerfile with documentation for both authentication methods

Security

  • Add automatic JWT token expiration validation before each API request
  • Add helpful error messages guiding users to refresh expired credentials

v0.0.1

01 Nov 20:56
d6b9720

Choose a tag to compare

Changelog

  • Initial release of Terramate MCP Server
  • Model Context Protocol (MCP) server implementation for Terramate Cloud integration
  • Terramate Cloud SDK with comprehensive API client
    • Stacks service for stack management
    • Drifts service for drift detection
    • Deployments service for CI/CD tracking
    • Review Requests service for PR/MR integration
    • Previews service for terraform plan debugging
    • Memberships service for organization management
  • MCP Tools for AI assistants:
    • tmc_authenticate - Authentication and organization membership
    • tmc_list_stacks - List and filter stacks with pagination
    • tmc_get_stack - Get detailed stack information
    • tmc_list_drifts - List drift detection runs
    • tmc_get_drift - Get drift details with terraform plans
    • tmc_list_review_requests - List pull/merge requests
    • tmc_get_review_request - Get PR details with terraform plans
    • tmc_get_stack_preview_logs - Debug failed terraform plans
    • tmc_list_deployments - List CI/CD deployments
    • tmc_get_stack_deployment - Get deployment details
    • tmc_get_deployment_logs - Debug failed deployments
  • HTTP client with automatic retry logic and exponential backoff
  • Graceful shutdown handling for SIGINT and SIGTERM signals
  • Configuration via environment variables and CLI flags
  • Support for EU and US regions
  • Docker support with multi-stage builds
  • Comprehensive test suite with race detector and coverage
  • GitHub Actions CI/CD pipeline
  • Automated Docker image publishing to GitHub Container Registry
  • Documentation and usage examples