OpenRouter MCP Server

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [2.3.0] - 2025-06-18 ### Added - (provider-routing) Comprehensive provider routing controls for chat_completion tool - max_tokens parameter to filter providers by output capacity - Provider filtering by quantizations and ignore lists - Provider sorting by price, throughput, or latency - Explicit provider preference using order - Model suffix shortcuts (:nitro, :floor) - Environment variables for default routing behavior ### Changed - Updated descriptions for `chat_completion`, `get_model_info`, and `validate_model` tools for improved clarity and detail. ## [2.2.0] - 2025-03-27 ### Added - Unified ToolResult response format for all tool handlers - Structured error messages with "Error: " prefix consistency - Comprehensive error handling documentation in README ### Changed - Updated all tool handlers to use new response format - Improved error messages with contextual information - Refactored core error handling infrastructure ### Fixed - Removed residual JSON-RPC error code references - Standardized success/error response structures ## [2.1.0] - 2025-02-10 ### Added - Conversation context support - MCP server badge ### Refactor - Modular structure ### Chore - Bump version to 2.1.0 - Update dependencies and TypeScript config - Update .gitignore remove project specific files ### Documentation - Improve README with comprehensive documentation and badges ## [2.0.3] - 2024-03-22 ### Changed - Updated dependencies to latest versions: - axios to ^1.7.9 - openai to ^4.77.0 - typescript to ^5.7.2 - Updated .gitignore file list - Fixed package.json bin configuration format ### Added - Package overrides to fix punycode deprecation warning: - Added uri-js-replace to replace deprecated uri-js - Updated whatwg-url to v14.1.0 ### Fixed - Updated repository URLs to correct GitHub repository - Fixed Node.js punycode deprecation warning (DEP0040) ## [2.0.2] - 2024-03-21 ### Changed - Simplified binary name to 'openrouterai' ## [2.0.1] - 2024-03-21 ### Added - Complete npm package configuration - Binary support for CLI installation - Repository and documentation links - Node.js engine requirement specification - PrepublishOnly script for build safety ## [2.0.0] - 2024-03-20 ### Breaking Changes - Remove list_models tool in favor of enhanced search_models - Remove set_default_model and clear_default_model in favor of config-based default model - Move default model to MCP configuration via OPENROUTER_DEFAULT_MODEL environment variable ### Added - Comprehensive model filtering capabilities - Direct OpenRouter /models endpoint integration - Accurate model data (pricing, context length, capabilities) - Rate limiting with exponential backoff - Model capability validation - Cache invalidation strategy - Enhanced error handling with detailed feedback ### Changed - Rename StateManager to ModelCache for better clarity - Update error messages to reference MCP configuration - Switch from OpenAI SDK models.list() to direct OpenRouter API calls - Update package name to @mcpservers/openrouterai - Update documentation to follow MCP server standards ## [1.0.0] - 2024-03-15 ### Added - Initial OpenRouter MCP server implementation - Basic model management features and state handling - Core API integration - Project documentation and configuration files ### Changed - Update license to Apache 2.0 [Unreleased]: https://github.com/mcpservers/openrouterai/compare/v2.3.0...HEAD [2.3.0]: https://github.com/mcpservers/openrouterai/compare/v2.2.0...v2.3.0 [2.2.0]: https://github.com/mcpservers/openrouterai/compare/v2.1.0...v2.2.0 [2.0.2]: https://github.com/mcpservers/openrouterai/compare/v2.0.1...v2.0.2 [2.0.1]: https://github.com/mcpservers/openrouterai/compare/v2.0.0...v2.0.1 [2.0.0]: https://github.com/mcpservers/openrouterai/compare/v1.0.0...v2.0.0 [1.0.0]: https://github.com/mcpservers/openrouterai/releases/tag/v1.0.0