windsock-mcp 0.1.0__tar.gz

windsock_mcp-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+*.egg-info/
+__pycache__/
+.venv/
+build/
+.DS_Store

windsock_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.5
+Name: windsock-mcp
+Version: 0.1.0
+Summary: Windsock aircraft intelligence for AI agents: stdio bridge and client helper for the Windsock MCP server (valuations, FAA registry, cost of ownership, market data, reports, logbooks).
+Project-URL: Homepage, https://windsock.ai/mcp
+Project-URL: Documentation, https://windsock.ai/mcp
+Project-URL: Support, https://windsock.ai/contact
+Author-email: Windsock <team@windsock.ai>
+License-Expression: MIT
+Keywords: agents,aircraft,aviation,faa,mcp,model-context-protocol,registry,valuation,windsock
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.10
+Description-Content-Type: text/markdown
+
+# windsock-mcp
+
+Windsock aircraft intelligence for AI agents, from Python.
+
+[Windsock](https://windsock.ai) exposes 38 tools over the Model Context Protocol
+at `https://windsock.ai/mcp`: aircraft valuations, FAA registry lookups, cost of
+ownership, comparable aircraft, fleet search, ADs and STCs, market metrics with
+forecasts, verified value reports, pre-buy diligence checklists, logbook search
+and a watchlist. This package gives you a client helper and a stdio bridge.
+
+```bash
+pip install windsock-mcp
+export WINDSOCK_API_KEY=wsk_…   # Integrations → Agents & SDKs in your Windsock account
+```
+
+## Call tools directly
+
+```python
+import asyncio
+from windsock_mcp import connect
+
+async def main():
+    async with connect() as session:
+        tools = await session.list_tools()
+        print([t.name for t in tools.tools])
+        result = await session.call_tool("lookup_aircraft", {"registration": "N12345"})
+        print(result.content[0].text)
+
+asyncio.run(main())
+```
+
+## Use as a stdio MCP server
+
+```json
+{
+  "mcpServers": {
+    "windsock": {
+      "command": "windsock-mcp",
+      "env": { "WINDSOCK_API_KEY": "wsk_…" }
+    }
+  }
+}
+```
+
+## Docs
+
+- https://windsock.ai/mcp — endpoint, auth, quickstarts, full tool catalog
+- https://windsock.ai/mcp/llms.txt — machine-readable index
+
+MIT © Windsock

windsock_mcp-0.1.0/README.md

@@ -0,0 +1,50 @@
+# windsock-mcp
+
+Windsock aircraft intelligence for AI agents, from Python.
+
+[Windsock](https://windsock.ai) exposes 38 tools over the Model Context Protocol
+at `https://windsock.ai/mcp`: aircraft valuations, FAA registry lookups, cost of
+ownership, comparable aircraft, fleet search, ADs and STCs, market metrics with
+forecasts, verified value reports, pre-buy diligence checklists, logbook search
+and a watchlist. This package gives you a client helper and a stdio bridge.
+
+```bash
+pip install windsock-mcp
+export WINDSOCK_API_KEY=wsk_…   # Integrations → Agents & SDKs in your Windsock account
+```
+
+## Call tools directly
+
+```python
+import asyncio
+from windsock_mcp import connect
+
+async def main():
+    async with connect() as session:
+        tools = await session.list_tools()
+        print([t.name for t in tools.tools])
+        result = await session.call_tool("lookup_aircraft", {"registration": "N12345"})
+        print(result.content[0].text)
+
+asyncio.run(main())
+```
+
+## Use as a stdio MCP server
+
+```json
+{
+  "mcpServers": {
+    "windsock": {
+      "command": "windsock-mcp",
+      "env": { "WINDSOCK_API_KEY": "wsk_…" }
+    }
+  }
+}
+```
+
+## Docs
+
+- https://windsock.ai/mcp — endpoint, auth, quickstarts, full tool catalog
+- https://windsock.ai/mcp/llms.txt — machine-readable index
+
+MIT © Windsock

windsock_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "windsock-mcp"
+version = "0.1.0"
+description = "Windsock aircraft intelligence for AI agents: stdio bridge and client helper for the Windsock MCP server (valuations, FAA registry, cost of ownership, market data, reports, logbooks)."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Windsock", email = "team@windsock.ai" }]
+keywords = ["mcp", "model-context-protocol", "aviation", "aircraft", "valuation", "faa", "registry", "windsock", "agents"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = ["mcp>=1.10", "httpx>=0.27", "anyio>=4"]
+
+[project.urls]
+Homepage = "https://windsock.ai/mcp"
+Documentation = "https://windsock.ai/mcp"
+Support = "https://windsock.ai/contact"
+
+[project.scripts]
+windsock-mcp = "windsock_mcp.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/windsock_mcp"]

windsock_mcp-0.1.0/src/windsock_mcp/__init__.py

@@ -0,0 +1,56 @@
+"""Windsock aircraft intelligence for AI agents.
+
+* :func:`connect` — async context manager yielding an initialized
+  :class:`mcp.ClientSession` to the remote Windsock MCP server
+  (``https://windsock.ai/mcp``), authenticated with your account API key.
+* ``windsock-mcp`` / ``python -m windsock_mcp`` — a stdio bridge so clients that
+  only speak stdio can use the remote server.
+
+Docs: https://windsock.ai/mcp
+"""
+
+from __future__ import annotations
+
+import os
+from contextlib import asynccontextmanager
+from typing import AsyncIterator
+
+from mcp import ClientSession
+from mcp.client.streamable_http import create_mcp_http_client, streamable_http_client
+
+SERVER_URL = "https://windsock.ai/mcp"
+
+__all__ = ["SERVER_URL", "connect", "headers_for"]
+
+
+def headers_for(api_key: str | None = None) -> dict[str, str]:
+    """Bearer header for the account API key (``WINDSOCK_API_KEY`` if omitted)."""
+    key = (api_key or os.environ.get("WINDSOCK_API_KEY", "")).strip()
+    if not key:
+        raise ValueError(
+            "A Windsock API key is required: pass api_key= or set WINDSOCK_API_KEY. "
+            "Get one at https://windsock.ai/app/integrations#mcp-agents"
+        )
+    return {"Authorization": f"Bearer {key}"}
+
+
+@asynccontextmanager
+async def connect(
+    api_key: str | None = None, url: str | None = None
+) -> AsyncIterator[ClientSession]:
+    """Open an initialized :class:`mcp.ClientSession` to the Windsock MCP server.
+
+    Example::
+
+        async with connect() as session:
+            tools = await session.list_tools()
+            result = await session.call_tool("lookup_aircraft", {"registration": "N12345"})
+    """
+    server_url = url or os.environ.get("WINDSOCK_MCP_URL", SERVER_URL)
+    http_client = create_mcp_http_client(headers=headers_for(api_key))
+    async with http_client:
+        async with streamable_http_client(server_url, http_client=http_client) as streams:
+            read, write = streams[0], streams[1]
+            async with ClientSession(read, write) as session:
+                await session.initialize()
+                yield session

windsock_mcp-0.1.0/src/windsock_mcp/__main__.py

@@ -0,0 +1,51 @@
+"""``windsock-mcp`` — stdio bridge to the remote Windsock MCP server.
+
+Forwards ``tools/list`` and ``tools/call`` from a stdio client to
+``https://windsock.ai/mcp`` using the account API key in ``WINDSOCK_API_KEY``.
+For interactive OAuth use prefer the npm bridge (``npx windsock-mcp``), which
+handles the browser consent flow.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import sys
+
+import mcp.types as types
+from mcp import stdio_server
+from mcp.server import Server
+
+from . import connect
+
+
+async def _serve() -> None:
+    async with connect() as upstream:
+
+        async def on_list_tools(_ctx, params):
+            return await upstream.list_tools(cursor=params.cursor if params else None)
+
+        async def on_call_tool(_ctx, params: types.CallToolRequestParams):
+            return await upstream.call_tool(params.name, params.arguments or {})
+
+        server: Server = Server(
+            "windsock",
+            website_url="https://windsock.ai/mcp",
+            on_list_tools=on_list_tools,
+            on_call_tool=on_call_tool,
+        )
+        async with stdio_server() as (read, write):
+            await server.run(read, write, server.create_initialization_options())
+
+
+def main() -> None:
+    try:
+        asyncio.run(_serve())
+    except ValueError as err:  # missing key
+        print(f"windsock-mcp: {err}", file=sys.stderr)
+        sys.exit(2)
+    except KeyboardInterrupt:
+        pass
+
+
+if __name__ == "__main__":
+    main()