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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-openapi-proxy
-Version: 0.3.0
+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,27 +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 | unknown ‡ |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: ❌ † |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ † |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | prompts: ❌ · resources: ✅ (`access_mcp_resource`) † |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | unknown ‡ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | prompts: ❌ · resources: ❌ (tools-only) † |
+| **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 | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | unknown ‡ |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | unknown ‡ |
-
-> **Prompts/resources column — read this.** The original 0.2.0 sweep ran while the
-> server advertised prompts/resources **only when `ENABLE_PROMPTS`/`ENABLE_RESOURCES`
-> were set — they defaulted OFF.** Per the MCP spec a client won't call
-> `prompts/list`/`resources/list` unless the capability is advertised, so those early
-> results measured the *server's* default, not the clients. **All prior prompt/resource
-> findings are therefore voided.** This release defaults advertising **on**.
+| 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** with advertising on, against the real client binary. Genuine, uneven: **tools** everywhere; **prompts→model** Qwen (slash) & Gemini (interactive only); **resources→model** Kilocode. Vibe is tools-only (confirmed in source).
-> - **‡ unknown** — not yet re-tested under advertising-on (opencode not installed here; Letta needs a running server + gateway; Codex parked). Prior ❌ values are not carried forward.
+> - **‖ 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.
 >
-> Tool-calling (the `Tool calls` column) was unaffected by the advertising default and stands as originally verified.
+> *(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.3.0 → mcp_openapi_proxy-0.3.1}/README.md

@@ -153,27 +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 | unknown ‡ |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: ❌ † |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ † |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | prompts: ❌ · resources: ✅ (`access_mcp_resource`) † |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | unknown ‡ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | prompts: ❌ · resources: ❌ (tools-only) † |
+| **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 | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | unknown ‡ |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | unknown ‡ |
-
-> **Prompts/resources column — read this.** The original 0.2.0 sweep ran while the
-> server advertised prompts/resources **only when `ENABLE_PROMPTS`/`ENABLE_RESOURCES`
-> were set — they defaulted OFF.** Per the MCP spec a client won't call
-> `prompts/list`/`resources/list` unless the capability is advertised, so those early
-> results measured the *server's* default, not the clients. **All prior prompt/resource
-> findings are therefore voided.** This release defaults advertising **on**.
+| 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** with advertising on, against the real client binary. Genuine, uneven: **tools** everywhere; **prompts→model** Qwen (slash) & Gemini (interactive only); **resources→model** Kilocode. Vibe is tools-only (confirmed in source).
-> - **‡ unknown** — not yet re-tested under advertising-on (opencode not installed here; Letta needs a running server + gateway; Codex parked). Prior ❌ values are not carried forward.
+> - **‖ 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.
 >
-> Tool-calling (the `Tool calls` column) was unaffected by the advertising default and stands as originally verified.
+> *(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.3.0 → 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.3.0
+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,27 +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 | unknown ‡ |
-| Gemini | Google OAuth free tier (CLI default model) | project `.gemini/settings.json` `mcpServers` | ✅ native | prompts: interactive slash only · resources: ❌ † |
-| Qwen | `agent` group via local LiteLLM gateway | project `.qwen/settings.json` | ✅ native | prompts: ✅ (slash `/summarize_spec`) · resources: ❌ † |
-| Kilocode | `kilo-auto/free` | global `settings/mcp_settings.json`, clean workspace | ✅ native | prompts: ❌ · resources: ✅ (`access_mcp_resource`) † |
-| opencode | `orchestration` group via local LiteLLM gateway | `~/.config/opencode/opencode.json` `mcp` | ✅ native | unknown ‡ |
-| Vibe | `mistral-medium-3.5` | `~/.vibe/config.toml` `[[mcp_servers]]` | ✅ discovery + reads (writes flaky) | prompts: ❌ · resources: ❌ (tools-only) † |
+| **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 | Letta Cloud default | streamable-HTTP MCP URL (`/mcp add --transport http` + bearer) | ✅ remote (stdio rejected) | unknown ‡ |
-| letta (self-hosted ≤0.11.x) | `agent` group via local LiteLLM gateway | stdio via `PUT /v1/tools/mcp/servers` | ✅ native | unknown ‡ |
-
-> **Prompts/resources column — read this.** The original 0.2.0 sweep ran while the
-> server advertised prompts/resources **only when `ENABLE_PROMPTS`/`ENABLE_RESOURCES`
-> were set — they defaulted OFF.** Per the MCP spec a client won't call
-> `prompts/list`/`resources/list` unless the capability is advertised, so those early
-> results measured the *server's* default, not the clients. **All prior prompt/resource
-> findings are therefore voided.** This release defaults advertising **on**.
+| 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** with advertising on, against the real client binary. Genuine, uneven: **tools** everywhere; **prompts→model** Qwen (slash) & Gemini (interactive only); **resources→model** Kilocode. Vibe is tools-only (confirmed in source).
-> - **‡ unknown** — not yet re-tested under advertising-on (opencode not installed here; Letta needs a running server + gateway; Codex parked). Prior ❌ values are not carried forward.
+> - **‖ 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.
 >
-> Tool-calling (the `Tool calls` column) was unaffected by the advertising default and stands as originally verified.
+> *(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.3.0 → 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.3.0"
+version = "0.3.1"
 description = "MCP server for exposing OpenAPI specifications as MCP tools."
 readme = "README.md"
 authors = [