open-agent-search 1.0.4 → 1.0.5

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agent-search",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Search public sources and fetch page content with local MCP tools.",
   "author": {
     "name": "Xplormity Collective"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agent-search",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Search public sources and fetch page content with local MCP tools.",
   "author": {
     "name": "Xplormity Collective"

package/.mcp.json

@@ -6,7 +6,7 @@
         "--python",
         "3.12",
         "--from",
-        "open-agent-search==1.0.4",
+        "open-agent-search==1.0.5",
         "oas-mcp"
       ]
     }

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Jayanth-MKV
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Jayanth-MKV
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
+<!-- mcp-name: io.github.jayanth-mkv/open-agent-search -->
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/jayanth-mkv/open-agent-search/main/docs/assets/logo.svg" width="132" alt="Open Agent Search logo">
 </p>
@@ -7,6 +9,7 @@
 <p align="center"><strong>One self-hostable search and content layer for AI agents and applications.</strong></p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/open-agent-search"><img alt="npm" src="https://img.shields.io/npm/v/open-agent-search"></a>
   <a href="https://pypi.org/project/open-agent-search/"><img alt="PyPI" src="https://img.shields.io/pypi/v/open-agent-search"></a>
   <a href="https://www.python.org/"><img alt="Python 3.12+" src="https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&logoColor=white"></a>
   <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/License-MIT-2EA44F"></a>
@@ -44,10 +47,10 @@ one web search. Tell me if a client restart is needed. No API key is required.
 With Node.js 22+ and [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
 
 ```sh
-npx --yes open-agent-search@1.0.4 --version
-npx --yes open-agent-search@1.0.4 mcp
+npx --yes open-agent-search@1.0.5 --version
+npx --yes open-agent-search@1.0.5 mcp
 # Or start the HTTP API:
-npx --yes open-agent-search@1.0.4 serve
+npx --yes open-agent-search@1.0.5 serve
 ```
 
 The npm launcher uses the pinned Python core. It requires uv on PATH; uv manages Python 3.12 and dependencies.
@@ -55,7 +58,7 @@ The npm launcher uses the pinned Python core. It requires uv on PATH; uv manages
 With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed, run the MCP server in an isolated environment:
 
 ```sh
-uvx --python 3.12 --from open-agent-search==1.0.4 oas-mcp
+uvx --python 3.12 --from open-agent-search==1.0.5 oas-mcp
 ```
 
 `uv` can download Python 3.12 when it is missing. The first run downloads dependencies; the client starts and stops this stdio process after configuration.
@@ -63,7 +66,7 @@ uvx --python 3.12 --from open-agent-search==1.0.4 oas-mcp
 For a persistent PyPI installation and HTTP server:
 
 ```sh
-uv tool install --python 3.12 open-agent-search==1.0.4
+uv tool install --python 3.12 open-agent-search==1.0.5
 open-agent-search
 ```
 
@@ -100,7 +103,7 @@ Search sources, transports, and client integrations can evolve without changing
 ### Add search to Claude Code
 
 ```bash
-claude mcp add oas -- uvx --python 3.12 --from open-agent-search==1.0.4 oas-mcp
+claude mcp add oas -- uvx --python 3.12 --from open-agent-search==1.0.5 oas-mcp
 ```
 
 Restart Claude Code, then ask it to search the web, news, images, videos, or books. The same `uvx` command works with Cursor, VS Code, Windsurf, OpenClaw, and other MCP clients.
@@ -113,7 +116,7 @@ Restart Claude Code, then ask it to search the web, news, images, videos, or boo
   "mcpServers": {
     "open-agent-search": {
       "command": "uvx",
-      "args": ["--python", "3.12", "--from", "open-agent-search==1.0.4", "oas-mcp"]
+      "args": ["--python", "3.12", "--from", "open-agent-search==1.0.5", "oas-mcp"]
     }
   }
 }
@@ -124,7 +127,7 @@ Restart Claude Code, then ask it to search the web, news, images, videos, or boo
 ### Run the HTTP API
 
 ```bash
-uv tool install --python 3.12 open-agent-search==1.0.4
+uv tool install --python 3.12 open-agent-search==1.0.5
 open-agent-search
 ```
 
@@ -156,7 +159,7 @@ The local MCP command and the HTTP service share the same search and content cap
 
 | Path | Command or endpoint | Best for |
 | --- | --- | --- |
-| Local MCP | `uvx --python 3.12 --from open-agent-search==1.0.4 oas-mcp` | Giving a desktop or coding agent search with no persistent server |
+| Local MCP | `uvx --python 3.12 --from open-agent-search==1.0.5 oas-mcp` | Giving a desktop or coding agent search with no persistent server |
 | HTTP service | `open-agent-search` | Applications, shared agent environments, REST clients, and remote MCP |
 
 ## Search surface
@@ -207,6 +210,15 @@ Deployment details: [Docker](https://jayanth-mkv.github.io/open-agent-search/dep
 - [API endpoints](https://jayanth-mkv.github.io/open-agent-search/api/endpoints/)
 - [Contributing](https://jayanth-mkv.github.io/open-agent-search/contributing/)
 
+## Registries and agent discovery
+
+- Packages: [npm](https://www.npmjs.com/package/open-agent-search) and [PyPI](https://pypi.org/project/open-agent-search/).
+- MCP Registry namespace: `io.github.jayanth-mkv/open-agent-search`. The release workflow publishes `server.json` after both packages are available. [Check the registry record](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.jayanth-mkv%2Fopen-agent-search).
+- Agent skills: install `open-agent-search` and `open-agent-search-setup` using the commands above. The [skills.sh directory](https://skills.sh/docs/faq) discovers skills through real installations; a repository alone does not guarantee a listing.
+- Glama: `glama.json` declares the GitHub maintainer. Directory submission and ownership verification require a separate Glama sign-in.
+
+The npm path requires Node.js 22+ and uv. The PyPI path uses uv to manage Python 3.12. This project provides a local server and deployment code; it does not provide a shared hosted search endpoint.
+
 ## Development
 
 ```bash

package/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "jayanth-mkv"
+  ]
+}

package/mcp.json

@@ -8,7 +8,7 @@
         "--python",
         "3.12",
         "--from",
-        "open-agent-search==1.0.4",
+        "open-agent-search==1.0.5",
         "oas-mcp"
       ]
     }

package/npm/runtime.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-export const VERSION = '1.0.4';
+export const VERSION = '1.0.5';
 export function commandFor(args, forced) {
   const mode = forced || args[0];
   if (!['mcp', 'serve'].includes(mode)) throw new Error('Choose mcp or serve. Run open-agent-search --help for commands.');

package/package.json

@@ -1,17 +1,56 @@
 {
   "name": "open-agent-search",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Self-hostable web search and content tools for AI agents, with stdio MCP and HTTP API support.",
   "type": "module",
-  "bin": { "open-agent-search": "npm/cli.js", "oas-mcp": "npm/mcp.js" },
-  "engines": { "node": ">=22" },
-  "files": ["npm/cli.js", "npm/mcp.js", "npm/runtime.js", "skills", "plugin.json", "mcp.json", ".mcp.json", ".codex-plugin/plugin.json", ".claude-plugin/plugin.json", "README.md", "LICENSE"],
-  "scripts": { "test": "node --test npm/*.test.js" },
+  "bin": {
+    "open-agent-search": "npm/cli.js",
+    "oas-mcp": "npm/mcp.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "npm/cli.js",
+    "npm/mcp.js",
+    "npm/runtime.js",
+    "skills",
+    "plugin.json",
+    "mcp.json",
+    ".mcp.json",
+    ".codex-plugin/plugin.json",
+    ".claude-plugin/plugin.json",
+    "README.md",
+    "LICENSE",
+    "server.json",
+    "glama.json"
+  ],
+  "scripts": {
+    "test": "node --test npm/*.test.js"
+  },
   "author": "Xplormity Collective",
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/jayanth-mkv/open-agent-search.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jayanth-mkv/open-agent-search.git"
+  },
   "homepage": "https://jayanth-mkv.github.io/open-agent-search/",
-  "bugs": { "url": "https://github.com/jayanth-mkv/open-agent-search/issues" },
-  "keywords": ["mcp", "ai", "agent", "search", "duckduckgo", "web-search", "agent-skills", "self-hosted", "cli"],
-  "publishConfig": { "access": "public" }
+  "bugs": {
+    "url": "https://github.com/jayanth-mkv/open-agent-search/issues"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "agent",
+    "search",
+    "duckduckgo",
+    "web-search",
+    "agent-skills",
+    "self-hosted",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "mcpName": "io.github.jayanth-mkv/open-agent-search"
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "open-agent-search",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Search public sources and fetch page content with local MCP tools.",
   "author": {
     "name": "Xplormity Collective"

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.jayanth-mkv/open-agent-search",
+  "title": "Open Agent Search",
+  "description": "Search the web, news, images, videos and books, and extract page content for AI agents.",
+  "repository": {
+    "url": "https://github.com/jayanth-mkv/open-agent-search",
+    "source": "github"
+  },
+  "websiteUrl": "https://jayanth-mkv.github.io/open-agent-search/",
+  "version": "1.0.5",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "open-agent-search",
+      "version": "1.0.5",
+      "transport": { "type": "stdio" },
+      "packageArguments": [{ "type": "positional", "value": "mcp" }]
+    },
+    {
+      "registryType": "pypi",
+      "identifier": "open-agent-search",
+      "version": "1.0.5",
+      "runtimeHint": "uvx",
+      "runtimeArguments": [
+        { "type": "named", "name": "--python", "value": "3.12" },
+        { "type": "named", "name": "--from", "value": "open-agent-search==1.0.5" }
+      ],
+      "packageArguments": [{ "type": "positional", "value": "oas-mcp" }],
+      "transport": { "type": "stdio" }
+    }
+  ]
+}

package/skills/open-agent-search/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Open Agent Search"
-  short_description: "Search public sources and fetch page evidence"
-  default_prompt: "Use $open-agent-search to research this topic and cite the sources."
+interface:
+  display_name: "Open Agent Search"
+  short_description: "Search public sources and fetch page evidence"
+  default_prompt: "Use $open-agent-search to research this topic and cite the sources."

package/skills/open-agent-search-setup/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Set up Open Agent Search"
-  short_description: "Connect local search tools to your coding agent"
-  default_prompt: "Use $open-agent-search-setup to connect Open Agent Search in this project."
+interface:
+  display_name: "Set up Open Agent Search"
+  short_description: "Connect local search tools to your coding agent"
+  default_prompt: "Use $open-agent-search-setup to connect Open Agent Search in this project."