mcp-openapi-proxy 0.2.1__tar.gz → 0.3.1__tar.gz

{mcp_openapi_proxy-0.2.1 → mcp_openapi_proxy-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-openapi-proxy
-Version: 0.2.1
+Version: 0.3.1
 Summary: MCP server for exposing OpenAPI specifications as MCP tools.
 Author-email: Matthew Hand <11550632+matthewhand@users.noreply.github.com>
 Requires-Python: >=3.10
@@ -175,15 +175,32 @@ The example configurations below were exercised against the live APIs, and the p
 
 | Agent CLI | Model used (live test) | MCP attach mechanism | Tool calls | Prompts/Resources surfaced to model? |
 |---|---|---|---|---|
-| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | ❌ (used raw stdio) |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | ❌ interactive slash-commands only |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | ❌ NO_PROMPT_ACCESS |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | ❌ |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | ❌ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | ❌ |
-| agy | — | — | ❌ headless cannot enable MCP | — |
-| letta cloud | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | — |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | — |
+| **opencode** | (CLI default) | `~/.config/opencode/opencode.json` `mcp` | ✅ native | **prompts: ✅ (slash) · resources: ✅** — most complete ‖ |
+| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | prompts: ❌ (no prompt meta-tools) · resources: ✅ (`read_mcp_resource`) ‖ |
+| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json` | ✅ native | prompts: ❌ (no prompt mechanism) · resources: ✅ (`access_mcp_resource`) ‖ |
+| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native (live invoke auth-blocked) | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ (no client support) ‖ |
+| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: interactive `@` only (neither reaches the model headless) ‖ |
+| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads | prompts: ❌ · resources: ❌ (tools-only client) ‖ |
+| agy | — | — | ❌ headless cannot enable MCP | n/a |
+| letta (cloud / self-hosted) | Letta Cloud / `PUT /v1/tools/mcp/servers` | streamable-HTTP / stdio | ✅ (per prior sweep) | unknown — needs a running Letta server to test ‡ |
+
+> **How to read the prompts/resources column.** MCP has three surfaces — tools, prompts,
+> resources. **mcp-openapi-proxy serves all three, advertised by default since 0.3.0.**
+> Whether they reach the model is up to the *client*, and that varies:
+>
+> - **‖ re-verified 2026-06-14 against the published 0.3.0 release** with **no** flags set
+>   (validating the default-on advertising), driving each **real client binary**.
+> - **Tools** work on every client tested. **Prompts→model**: opencode & Qwen (slash
+>   commands); Gemini interactive-only. **Resources→model**: opencode, Codex, Kilocode.
+>   **opencode is the only client that surfaces all three.** Vibe is tools-only.
+> - **‡ unknown** — Letta can't be exercised without standing up a Letta server + model;
+>   left untested rather than guessed.
+> - Every cell on the proxy side was confirmed via a raw stdio handshake (`initialize`
+>   advertises tools+prompts+resources; `prompts/get` and `resources/read` return content).
+>   The remaining ❌ are **client-side** gaps, not proxy limitations.
+>
+> *(All pre-0.3.0 prompt/resource findings were voided — they were measured while
+> advertising defaulted off, so they reflected the server default, not the clients.)*
 
 Minimal sanitized configs per client (the no-auth Glama spec is used as the smallest working example; substitute your own spec URL and `$YOUR_KEY` as needed):
 

{mcp_openapi_proxy-0.2.1 → mcp_openapi_proxy-0.3.1}/README.md

@@ -153,15 +153,32 @@ The example configurations below were exercised against the live APIs, and the p
 
 | Agent CLI | Model used (live test) | MCP attach mechanism | Tool calls | Prompts/Resources surfaced to model? |
 |---|---|---|---|---|
-| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | ❌ (used raw stdio) |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | ❌ interactive slash-commands only |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | ❌ NO_PROMPT_ACCESS |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | ❌ |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | ❌ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | ❌ |
-| agy | — | — | ❌ headless cannot enable MCP | — |
-| letta cloud | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | — |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | — |
+| **opencode** | (CLI default) | `~/.config/opencode/opencode.json` `mcp` | ✅ native | **prompts: ✅ (slash) · resources: ✅** — most complete ‖ |
+| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | prompts: ❌ (no prompt meta-tools) · resources: ✅ (`read_mcp_resource`) ‖ |
+| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json` | ✅ native | prompts: ❌ (no prompt mechanism) · resources: ✅ (`access_mcp_resource`) ‖ |
+| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native (live invoke auth-blocked) | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ (no client support) ‖ |
+| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: interactive `@` only (neither reaches the model headless) ‖ |
+| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads | prompts: ❌ · resources: ❌ (tools-only client) ‖ |
+| agy | — | — | ❌ headless cannot enable MCP | n/a |
+| letta (cloud / self-hosted) | Letta Cloud / `PUT /v1/tools/mcp/servers` | streamable-HTTP / stdio | ✅ (per prior sweep) | unknown — needs a running Letta server to test ‡ |
+
+> **How to read the prompts/resources column.** MCP has three surfaces — tools, prompts,
+> resources. **mcp-openapi-proxy serves all three, advertised by default since 0.3.0.**
+> Whether they reach the model is up to the *client*, and that varies:
+>
+> - **‖ re-verified 2026-06-14 against the published 0.3.0 release** with **no** flags set
+>   (validating the default-on advertising), driving each **real client binary**.
+> - **Tools** work on every client tested. **Prompts→model**: opencode & Qwen (slash
+>   commands); Gemini interactive-only. **Resources→model**: opencode, Codex, Kilocode.
+>   **opencode is the only client that surfaces all three.** Vibe is tools-only.
+> - **‡ unknown** — Letta can't be exercised without standing up a Letta server + model;
+>   left untested rather than guessed.
+> - Every cell on the proxy side was confirmed via a raw stdio handshake (`initialize`
+>   advertises tools+prompts+resources; `prompts/get` and `resources/read` return content).
+>   The remaining ❌ are **client-side** gaps, not proxy limitations.
+>
+> *(All pre-0.3.0 prompt/resource findings were voided — they were measured while
+> advertising defaulted off, so they reflected the server default, not the clients.)*
 
 Minimal sanitized configs per client (the no-auth Glama spec is used as the smallest working example; substitute your own spec URL and `$YOUR_KEY` as needed):
 

{mcp_openapi_proxy-0.2.1 → mcp_openapi_proxy-0.3.1}/mcp_openapi_proxy/server_lowlevel.py

@@ -14,8 +14,8 @@ Configuration is controlled via environment variables:
 - CAPABILITIES_RESOURCES: Set to "true" to enable resources advertising (default: false).
 - CAPABILITIES_PROMPTS: Set to "true" to enable prompts advertising (default: false).
 - ENABLE_TOOLS: Set to "false" to disable tools functionality (default: true).
-- ENABLE_RESOURCES: Set to "true" to enable resources functionality (default: false).
-- ENABLE_PROMPTS: Set to "true" to enable prompts functionality (default: false).
+- ENABLE_RESOURCES: Set to "false" to disable resources functionality (default: true).
+- ENABLE_PROMPTS: Set to "false" to disable prompts functionality (default: true).
 """
 
 import os
@@ -53,10 +53,13 @@ CAPABILITIES_TOOLS = os.getenv("CAPABILITIES_TOOLS", "false").lower() == "true"
 CAPABILITIES_RESOURCES = os.getenv("CAPABILITIES_RESOURCES", "false").lower() == "true"
 CAPABILITIES_PROMPTS = os.getenv("CAPABILITIES_PROMPTS", "false").lower() == "true"
 
-# Check feature enablement envvars (tools on, others off by default)
+# Feature enablement (all on by default). Advertising a capability is
+# required for clients to even attempt prompts/list & resources/list;
+# defaulting these OFF made prompts/resources invisible to every client
+# despite being implemented. Set to "false" to opt out.
 ENABLE_TOOLS = os.getenv("ENABLE_TOOLS", "true").lower() == "true"
-ENABLE_RESOURCES = os.getenv("ENABLE_RESOURCES", "false").lower() == "true"
-ENABLE_PROMPTS = os.getenv("ENABLE_PROMPTS", "false").lower() == "true"
+ENABLE_RESOURCES = os.getenv("ENABLE_RESOURCES", "true").lower() == "true"
+ENABLE_PROMPTS = os.getenv("ENABLE_PROMPTS", "true").lower() == "true"
 
 # Resource and prompt DEFINITIONS are always present so the feature is
 # deterministically testable. Whether they are EXPOSED to clients is gated

{mcp_openapi_proxy-0.2.1 → mcp_openapi_proxy-0.3.1}/mcp_openapi_proxy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-openapi-proxy
-Version: 0.2.1
+Version: 0.3.1
 Summary: MCP server for exposing OpenAPI specifications as MCP tools.
 Author-email: Matthew Hand <11550632+matthewhand@users.noreply.github.com>
 Requires-Python: >=3.10
@@ -175,15 +175,32 @@ The example configurations below were exercised against the live APIs, and the p
 
 | Agent CLI | Model used (live test) | MCP attach mechanism | Tool calls | Prompts/Resources surfaced to model? |
 |---|---|---|---|---|
-| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | ❌ (used raw stdio) |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | ❌ interactive slash-commands only |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | ❌ NO_PROMPT_ACCESS |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | ❌ |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | ❌ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | ❌ |
-| agy | — | — | ❌ headless cannot enable MCP | — |
-| letta cloud | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | — |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | — |
+| **opencode** | (CLI default) | `~/.config/opencode/opencode.json` `mcp` | ✅ native | **prompts: ✅ (slash) · resources: ✅** — most complete ‖ |
+| Codex | `gpt-5-codex` (OpenAI API) | `codex exec -c mcp_servers.*` | ✅ native | prompts: ❌ (no prompt meta-tools) · resources: ✅ (`read_mcp_resource`) ‖ |
+| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json` | ✅ native | prompts: ❌ (no prompt mechanism) · resources: ✅ (`access_mcp_resource`) ‖ |
+| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native (live invoke auth-blocked) | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ (no client support) ‖ |
+| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: interactive `@` only (neither reaches the model headless) ‖ |
+| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads | prompts: ❌ · resources: ❌ (tools-only client) ‖ |
+| agy | — | — | ❌ headless cannot enable MCP | n/a |
+| letta (cloud / self-hosted) | Letta Cloud / `PUT /v1/tools/mcp/servers` | streamable-HTTP / stdio | ✅ (per prior sweep) | unknown — needs a running Letta server to test ‡ |
+
+> **How to read the prompts/resources column.** MCP has three surfaces — tools, prompts,
+> resources. **mcp-openapi-proxy serves all three, advertised by default since 0.3.0.**
+> Whether they reach the model is up to the *client*, and that varies:
+>
+> - **‖ re-verified 2026-06-14 against the published 0.3.0 release** with **no** flags set
+>   (validating the default-on advertising), driving each **real client binary**.
+> - **Tools** work on every client tested. **Prompts→model**: opencode & Qwen (slash
+>   commands); Gemini interactive-only. **Resources→model**: opencode, Codex, Kilocode.
+>   **opencode is the only client that surfaces all three.** Vibe is tools-only.
+> - **‡ unknown** — Letta can't be exercised without standing up a Letta server + model;
+>   left untested rather than guessed.
+> - Every cell on the proxy side was confirmed via a raw stdio handshake (`initialize`
+>   advertises tools+prompts+resources; `prompts/get` and `resources/read` return content).
+>   The remaining ❌ are **client-side** gaps, not proxy limitations.
+>
+> *(All pre-0.3.0 prompt/resource findings were voided — they were measured while
+> advertising defaulted off, so they reflected the server default, not the clients.)*
 
 Minimal sanitized configs per client (the no-auth Glama spec is used as the smallest working example; substitute your own spec URL and `$YOUR_KEY` as needed):
 

{mcp_openapi_proxy-0.2.1 → mcp_openapi_proxy-0.3.1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "mcp-openapi-proxy"
 requires-python = ">=3.10"
-version = "0.2.1"
+version = "0.3.1"
 description = "MCP server for exposing OpenAPI specifications as MCP tools."
 readme = "README.md"
 authors = [