{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_p38jvb6xxxhg","handle":"yacy-mcp","url":"https://wellknown.network/agents/yacy-mcp","links":{"self":"https://wellknown.network/agents/yacy-mcp/record.json","html":"https://wellknown.network/agents/yacy-mcp","markdown":"https://wellknown.network/agents/yacy-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yacy-mcp","status":"https://wellknown.network/api/v1/agents/yacy-mcp/status","claim":"https://wellknown.network/agents/yacy-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yacy-mcp/claim.json","badge":"https://wellknown.network/agents/yacy-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yacy-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yacy-mcp","summary":"MCP (Model Context Protocol) Server implementation that provides AI tools to search using YaCy web search API","description":"# YaCy MCP Server\n\nMCP (Model Context Protocol) Server implementation that provides AI tools to search using YaCy web search API.\n\n## Installation\n\n1. Make sure you have `uv` installed:\n\n```bash\npip install uv\n```\n\n2. Install the package in development mode:\n\n```bash\ncd yacy-mcp\nuv sync  # Sync all dependencies from pyproject.toml and uv.lock\n```\n\nOr alternatively:\n\n```bash\ncd yacy-mcp\nuv pip install -e .\n```\n\n## Usage\n\n1. Make sure you have a YaCy server running (typically on http://localhost:8090)\n2. Set environment variables (optional):\n\n```bash\nexport YACY_URL=http://localhost:8090\n```\n\n3. Run the MCP server:\n\n```bash\npython -m yacy_mcp\n```\n\n## Configuration\n\nThe server can be configured using environment variables:\n\n- `YACY_URL`: URL of your YaCy instance (default: http://localhost:8090)\n\n## Available Tools\n\n- `yacy-search`: Search using YaCy web search engine\n  - Parameters:\n    - `query` (string, required): Search query string\n    - `max_results` (integer, optional): Maximum number of results to return (default: 10)\n    - `resource` (string, optional): Search resource (local or global, default: global)\n\n## MCP Configuration for AI Applications\n\nTo use this server with AI applications that support the Model Context Protocol (MCP), configure your MCP client to connect to the server using stdio transport.\n\nExample configuration for Claude Desktop (settings.json):\n```json\n{\n  \"mcpServers\": {\n    \"yacy-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"yacy_mcp\"],\n      \"env\": {\n        \"YACY_URL\": \"http://localhost:8090\"\n      }\n    }\n  }\n}\n```\n\nFor other MCP-compatible applications, use the command `uvx yacy_mcp` as the server executable. The server will be automatically fetched and run from PyPI.\n\n## Integration with AI Applications\n\nThis MCP server can be used with AI applications that support the Model Context Protocol to perform web searches using the YaCy search engine.","publisher":null,"homepage":"https://github.com/koosty/yacy-mcp","repository":"https://github.com/koosty/yacy-mcp/issues","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["ai","mcp","model-context-protocol","search","yacy"],"pricing":null,"endpoints":[{"url":"pypi:yacy-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"},{"slug":"data.web-search","name":"Web Search","confidence":0.894,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yacy-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:23.440Z","publishedAt":"2025-10-31T07:00:02.465044Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yacy-mcp","url":"https://pypi.org/project/yacy-mcp/","firstSeenAt":"2026-09-10T16:23:06.948Z","fetchedAt":"2026-09-10T16:23:06.948Z","normalizedAt":"2026-09-10T16:23:06.948Z"}]},"firstSeenAt":"2026-09-10T16:23:06.948Z","updatedAt":"2026-09-10T16:24:23.440Z"}