From 0dd9ed1517a8f76f512e744dac33abd55a2d2752 Mon Sep 17 00:00:00 2001 From: pumanitro Date: Thu, 9 Apr 2026 09:42:53 +0200 Subject: [PATCH] Add global-chat-mcp-ts skill for cross-protocol agent discovery MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a TypeScript MCP skill for Global Chat — a cross-protocol agent discovery platform that aggregates 18K+ MCP servers across 6+ registries. Includes: - SKILL.md with tool documentation and example workflows - references/mcp-config.md with setup for Copilot, Claude Code, and Cursor npm package: @global-chat/mcp-server --- .github/skills/global-chat-mcp-ts/SKILL.md | 82 ++++++++++++++ .../references/mcp-config.md | 103 ++++++++++++++++++ 2 files changed, 185 insertions(+) create mode 100644 .github/skills/global-chat-mcp-ts/SKILL.md create mode 100644 .github/skills/global-chat-mcp-ts/references/mcp-config.md diff --git a/.github/skills/global-chat-mcp-ts/SKILL.md b/.github/skills/global-chat-mcp-ts/SKILL.md new file mode 100644 index 00000000..e1ed329e --- /dev/null +++ b/.github/skills/global-chat-mcp-ts/SKILL.md @@ -0,0 +1,82 @@ +--- +name: global-chat-mcp-ts +description: Discover and search AI agents across MCP, A2A, and agents.txt protocols. Use when finding MCP servers, searching agent registries, validating agents.txt files, looking up agent capabilities across protocols, or building multi-agent systems that need discovery. TypeScript MCP server. +--- + +# Global Chat — Cross-Protocol Agent Discovery + +Search and discover AI agents across MCP, A2A, agents.txt, and other protocols from a single MCP server. Aggregates 18K+ MCP servers across 6+ registries with cross-search. + +## When to Use + +- Finding MCP servers for a specific capability or domain +- Searching agent registries across multiple protocols +- Validating an agents.txt file against the specification +- Looking up agent metadata, endpoints, or capabilities +- Building multi-agent systems that need runtime discovery + +## Quick Start + +```json +{ + "mcpServers": { + "global-chat": { + "command": "npx", + "args": ["-y", "@global-chat/mcp-server"] + } + } +} +``` + +No API key required. Works with Copilot, VS Code, Claude Code, Cursor, and any MCP client. + +## Available Tools + +| Tool | Purpose | +|------|---------| +| `search_mcp_servers` | Search across 18K+ MCP servers by keyword, category, or capability | +| `get_mcp_server` | Get detailed info for a specific MCP server (config, tools, setup) | +| `search_a2a_agents` | Search agents using Google's Agent-to-Agent protocol | +| `validate_agents_txt` | Validate an agents.txt file against the specification | +| `get_agents_txt` | Fetch and parse an agents.txt file from any domain | + +## Example Workflows + +### Find MCP servers for a task + +``` +Agent: "I need to interact with GitHub repositories" +→ search_mcp_servers({ query: "github" }) +→ Returns matching servers with install configs +``` + +### Validate agents.txt before deploying + +``` +Agent: "Check if our agents.txt is valid" +→ validate_agents_txt({ url: "https://example.com/agents.txt" }) +→ Returns validation results with errors and warnings +``` + +### Discover A2A agents + +``` +Agent: "Find agents that can process invoices" +→ search_a2a_agents({ query: "invoice processing" }) +→ Returns A2A-compatible agents with endpoints +``` + +## Supported Protocols + +| Protocol | Description | +|----------|-------------| +| MCP | Model Context Protocol — tool integration for LLMs | +| A2A | Google Agent-to-Agent — inter-agent communication | +| agents.txt | Web standard for publishing agent capabilities | + +## Resources + +- Website: https://global-chat.io +- npm: https://www.npmjs.com/package/@global-chat/mcp-server +- GitHub: https://github.com/pumanitro/global-chat +- agents.txt validator: https://global-chat.io/agents-txt diff --git a/.github/skills/global-chat-mcp-ts/references/mcp-config.md b/.github/skills/global-chat-mcp-ts/references/mcp-config.md new file mode 100644 index 00000000..d86262d4 --- /dev/null +++ b/.github/skills/global-chat-mcp-ts/references/mcp-config.md @@ -0,0 +1,103 @@ +# MCP Server Configuration + +## Setup + +```json +{ + "mcpServers": { + "global-chat": { + "command": "npx", + "args": ["-y", "@global-chat/mcp-server"] + } + } +} +``` + +No environment variables or API keys required. + +## Agent Configurations + +### GitHub Copilot (VS Code) + +Add to `.vscode/mcp.json`: + +```json +{ + "servers": { + "global-chat": { + "command": "npx", + "args": ["-y", "@global-chat/mcp-server"] + } + } +} +``` + +### Claude Code + +Add to `.claude/settings.json` or use: + +```bash +claude mcp add global-chat -- npx -y @global-chat/mcp-server +``` + +### Cursor + +Add to `.cursor/mcp.json`: + +```json +{ + "mcpServers": { + "global-chat": { + "command": "npx", + "args": ["-y", "@global-chat/mcp-server"] + } + } +} +``` + +## Tool Details + +### search_mcp_servers + +Search the aggregated directory of MCP servers. + +**Parameters:** +- `query` (string, required) — Search term (e.g., "database", "github", "slack") + +**Returns:** Array of matching MCP servers with name, description, install command, and source registry. + +### get_mcp_server + +Get detailed information about a specific MCP server. + +**Parameters:** +- `name` (string, required) — Server name or package name + +**Returns:** Full server metadata including tools list, configuration, and setup instructions. + +### search_a2a_agents + +Search agents using Google's Agent-to-Agent protocol. + +**Parameters:** +- `query` (string, required) — Search term for agent capabilities + +**Returns:** Array of A2A-compatible agents with endpoints and capability descriptions. + +### validate_agents_txt + +Validate an agents.txt file against the specification. + +**Parameters:** +- `url` (string, required) — URL of the agents.txt file to validate + +**Returns:** Validation report with errors, warnings, and parsed agent entries. + +### get_agents_txt + +Fetch and parse an agents.txt file from a domain. + +**Parameters:** +- `domain` (string, required) — Domain to fetch agents.txt from + +**Returns:** Parsed agents.txt content with all agent entries and metadata.