fearch/server.json at main · funkyfunc/fearch · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "name": "io.github.funkyfunc/fearch",
  "description": "Respectful, corporate-safe, free web search and page reading for AI agents: honest identity, robots.txt, a human-in-the-loop browser tier, refusals as structured diagnoses, keyless official search.",
  "repository": {
    "url": "https://github.com/funkyfunc/fearch",
    "source": "github"
  },
  "version": "4.1.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "fearch-mcp",
      "version": "4.1.0",
      "transport": {
        "type": "stdio"
      },
      "packageArguments": [
        {
          "type": "named",
          "name": "--browser",
          "description": "auto | headless | extension | off — auto (default): headless until a site shows a challenge, which then opens in a visible window for the person (their own Chrome via the bridge extension when connected; final where no display exists).",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--robots",
          "description": "default | strict — robots.txt for the tool's own fetching.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--engines",
          "description": "Engine result pages in preference order: duckduckgo (default), google, google-ai (Google's AI Mode: its reply and the pages it cites). Google needs a person on call to approve each query and pass its checks.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--human-search",
          "description": "Google: each query is shown to the person in their MCP client, editable, and runs only when accepted.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--incognito",
          "description": "The person's own Chrome: open pages and result pages in an incognito window, not their profile.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--no-handoff",
          "description": "Never surface a bot check to the person; challenges are final.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--allow-domains",
          "description": "Comma-separated allow list of hosts (subdomains included).",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--deny-domains",
          "description": "Comma-separated deny list of hosts (subdomains included).",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--search",
          "description": "all | off — off disables the search tool.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--max-chars",
          "description": "Default character budget of a fetch result (12000).",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--locale",
          "description": "BCP-47 tag engines and Accept-Language speak; defaults to the machine's locale.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--cache-dir",
          "description": "Where the cache, browser profile and pairing token live (~/.cache/fearch).",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--audit-log",
          "description": "stderr | off | a file path — one JSON line per network request.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--log-level",
          "description": "debug | info | warn | error.",
          "isRequired": false
        },
        {
          "type": "named",
          "name": "--ua-info-url",
          "description": "URL shown in the User-Agent (defaults to the project's bot-info page).",
          "isRequired": false
        }
      ],
      "environmentVariables": [
        {
          "name": "GITHUB_TOKEN",
          "description": "Optional: higher GitHub API limits and code search.",
          "isRequired": false,
          "isSecret": true
        }
      ]
    }
  ]
}