auxiliar-mcp 0.22.0 → 0.22.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/about.d.ts +10 -0
- package/dist/about.js +16 -0
- package/dist/server.js +6 -20
- package/package.json +13 -33
- package/dist/data/capabilities.d.ts +0 -34
- package/dist/data/capabilities.generated.json +0 -32176
- package/dist/data/capabilities.js +0 -62
- package/dist/data/event-sources.d.ts +0 -47
- package/dist/data/event-sources.js +0 -125
- package/dist/data/pricing.d.ts +0 -1
- package/dist/data/pricing.js +0 -582
- package/dist/data/recommendations.d.ts +0 -1
- package/dist/data/recommendations.js +0 -2350
- package/dist/data/risks.d.ts +0 -1
- package/dist/data/risks.js +0 -366
- package/dist/data/solve.d.ts +0 -43
- package/dist/data/solve.js +0 -362
- package/dist/telemetry.d.ts +0 -64
- package/dist/telemetry.js +0 -99
- package/dist/tools/analytics.d.ts +0 -8
- package/dist/tools/analytics.js +0 -54
- package/dist/tools/compare-capabilities.d.ts +0 -35
- package/dist/tools/compare-capabilities.js +0 -101
- package/dist/tools/compatibility.d.ts +0 -16
- package/dist/tools/compatibility.js +0 -245
- package/dist/tools/find-capability.d.ts +0 -58
- package/dist/tools/find-capability.js +0 -161
- package/dist/tools/get-capability.d.ts +0 -21
- package/dist/tools/get-capability.js +0 -22
- package/dist/tools/invoke-capability.d.ts +0 -45
- package/dist/tools/invoke-capability.js +0 -109
- package/dist/tools/list-capabilities.d.ts +0 -39
- package/dist/tools/list-capabilities.js +0 -50
- package/dist/tools/list.d.ts +0 -23
- package/dist/tools/list.js +0 -106
- package/dist/tools/pricing.d.ts +0 -5
- package/dist/tools/pricing.js +0 -29
- package/dist/tools/recommend.d.ts +0 -42
- package/dist/tools/recommend.js +0 -331
- package/dist/tools/risks.d.ts +0 -5
- package/dist/tools/risks.js +0 -14
- package/dist/tools/setup.d.ts +0 -30
- package/dist/tools/setup.js +0 -316
- package/dist/tools/solve.d.ts +0 -31
- package/dist/tools/solve.js +0 -126
- package/dist/types/capability.d.ts +0 -276
- package/dist/types/capability.js +0 -191
package/dist/about.d.ts
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export declare const ABOUT: {
|
|
2
|
+
readonly product: "auxiliar.ai — web-access API gateway for AI agents";
|
|
3
|
+
readonly what_it_does: "Search, scrape, extract, and crawl the live web across many providers through one billed API. Upstream provider keys are injected server-side, so the agent never handles them; usage is credit-metered against your auxiliar account.";
|
|
4
|
+
readonly status: "The in-loop MCP client that wraps these capabilities is being rebuilt (v1.0). This package is currently a pointer during that transition.";
|
|
5
|
+
readonly how_to_use_today: "Get an API key at https://auxiliar.ai, then call the gateway directly over HTTP with your bearer token (one endpoint per capability).";
|
|
6
|
+
readonly links: {
|
|
7
|
+
readonly home: "https://auxiliar.ai";
|
|
8
|
+
readonly source: "https://github.com/Tlalvarez/Auxiliar-ai";
|
|
9
|
+
};
|
|
10
|
+
};
|
package/dist/about.js
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// The single source of truth for what `about_auxiliar` returns.
|
|
2
|
+
//
|
|
3
|
+
// auxiliar.ai is a web-access API gateway for AI agents. The in-loop MCP
|
|
4
|
+
// client that wraps the gateway's capabilities is being rebuilt for v1.0;
|
|
5
|
+
// until then this package ships one informational tool that points the
|
|
6
|
+
// agent at the gateway.
|
|
7
|
+
export const ABOUT = {
|
|
8
|
+
product: "auxiliar.ai — web-access API gateway for AI agents",
|
|
9
|
+
what_it_does: "Search, scrape, extract, and crawl the live web across many providers through one billed API. Upstream provider keys are injected server-side, so the agent never handles them; usage is credit-metered against your auxiliar account.",
|
|
10
|
+
status: "The in-loop MCP client that wraps these capabilities is being rebuilt (v1.0). This package is currently a pointer during that transition.",
|
|
11
|
+
how_to_use_today: "Get an API key at https://auxiliar.ai, then call the gateway directly over HTTP with your bearer token (one endpoint per capability).",
|
|
12
|
+
links: {
|
|
13
|
+
home: "https://auxiliar.ai",
|
|
14
|
+
source: "https://github.com/Tlalvarez/Auxiliar-ai",
|
|
15
|
+
},
|
|
16
|
+
};
|
package/dist/server.js
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
3
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
4
|
+
import { ABOUT } from "./about.js";
|
|
4
5
|
const server = new McpServer({
|
|
5
6
|
name: "auxiliar",
|
|
6
|
-
version: "0.22.
|
|
7
|
+
version: "0.22.1",
|
|
7
8
|
});
|
|
8
9
|
// ─────────────────────────────────────────────────────────────────────────
|
|
9
10
|
// Transitional surface.
|
|
@@ -12,26 +13,11 @@ const server = new McpServer({
|
|
|
12
13
|
// scrape / extract / crawl across many providers through one billed API,
|
|
13
14
|
// upstream keys injected server-side). The in-loop MCP client that wraps
|
|
14
15
|
// those capabilities is being rebuilt for v1.0. Until then this package
|
|
15
|
-
// ships a single informational tool that points the agent at the gateway
|
|
16
|
-
// rather than the prior capability-directory tools (removed) which no
|
|
17
|
-
// longer reflect what auxiliar.ai offers.
|
|
16
|
+
// ships a single informational tool that points the agent at the gateway.
|
|
18
17
|
// ─────────────────────────────────────────────────────────────────────────
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
product: "auxiliar.ai — web-access API gateway for AI agents",
|
|
23
|
-
what_it_does: "Search, scrape, extract, and crawl the live web across many providers through one billed API. Upstream provider keys are injected server-side, so the agent never handles them; usage is credit-metered against your auxiliar account.",
|
|
24
|
-
status: "The in-loop MCP client that wraps these capabilities is being rebuilt (v1.0). This package is currently a pointer during that transition.",
|
|
25
|
-
how_to_use_today: "Get an API key at https://auxiliar.ai, then call the gateway directly over HTTP with your bearer token (one endpoint per capability).",
|
|
26
|
-
links: {
|
|
27
|
-
home: "https://auxiliar.ai",
|
|
28
|
-
source: "https://github.com/Tlalvarez/Auxiliar-ai",
|
|
29
|
-
},
|
|
30
|
-
};
|
|
31
|
-
return {
|
|
32
|
-
content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
|
|
33
|
-
};
|
|
34
|
-
});
|
|
18
|
+
server.tool("about_auxiliar", "Describe what auxiliar.ai is and how an agent uses it today. auxiliar.ai is a web-access API gateway: search, scrape, extract, and crawl the live web across many providers through one billed API, with upstream keys injected server-side. Call this to learn how to get an API key and reach the gateway. (The in-loop web-access tools are in active development for v1.0.)", {}, async () => ({
|
|
19
|
+
content: [{ type: "text", text: JSON.stringify(ABOUT, null, 2) }],
|
|
20
|
+
}));
|
|
35
21
|
async function main() {
|
|
36
22
|
const transport = new StdioServerTransport();
|
|
37
23
|
await server.connect(transport);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "auxiliar-mcp",
|
|
3
|
-
"version": "0.22.
|
|
3
|
+
"version": "0.22.1",
|
|
4
4
|
"description": "Web access for AI agents — search, scrape, extract, and crawl across many providers through one billed API, upstream keys injected server-side. In-loop MCP client for the auxiliar.ai gateway; client surface in active development for v1.0.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/server.js",
|
|
@@ -12,8 +12,7 @@
|
|
|
12
12
|
"README.md"
|
|
13
13
|
],
|
|
14
14
|
"scripts": {
|
|
15
|
-
"build
|
|
16
|
-
"build": "npm run build:data && tsc && chmod +x dist/server.js",
|
|
15
|
+
"build": "rm -rf dist && tsc && chmod +x dist/server.js",
|
|
17
16
|
"test": "node --import tsx test.ts",
|
|
18
17
|
"dev": "tsc --watch",
|
|
19
18
|
"start": "node dist/server.js",
|
|
@@ -28,33 +27,16 @@
|
|
|
28
27
|
"claude-code",
|
|
29
28
|
"claude-desktop",
|
|
30
29
|
"cursor",
|
|
31
|
-
"windsurf",
|
|
32
30
|
"openclaw",
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"
|
|
36
|
-
"
|
|
37
|
-
"
|
|
38
|
-
"
|
|
39
|
-
"
|
|
40
|
-
"
|
|
41
|
-
"
|
|
42
|
-
"bookkeeping",
|
|
43
|
-
"brazilian-invoice",
|
|
44
|
-
"receipt-parsing",
|
|
45
|
-
"solve-task",
|
|
46
|
-
"task-ranking",
|
|
47
|
-
"agent-tools",
|
|
48
|
-
"agent-skills",
|
|
49
|
-
"tool-selection",
|
|
50
|
-
"agent-upgrade",
|
|
51
|
-
"cloud-services",
|
|
52
|
-
"pricing",
|
|
53
|
-
"developer-tools",
|
|
54
|
-
"infrastructure",
|
|
55
|
-
"surya",
|
|
56
|
-
"tesseract",
|
|
57
|
-
"google-document-ai"
|
|
31
|
+
"web-access",
|
|
32
|
+
"web-search",
|
|
33
|
+
"search-api",
|
|
34
|
+
"scraping",
|
|
35
|
+
"web-scraping",
|
|
36
|
+
"crawler",
|
|
37
|
+
"extract",
|
|
38
|
+
"gateway",
|
|
39
|
+
"api-gateway"
|
|
58
40
|
],
|
|
59
41
|
"license": "MIT",
|
|
60
42
|
"repository": {
|
|
@@ -67,13 +49,11 @@
|
|
|
67
49
|
"node": ">=18.0.0"
|
|
68
50
|
},
|
|
69
51
|
"dependencies": {
|
|
70
|
-
"@modelcontextprotocol/sdk": "^1.12.1"
|
|
71
|
-
"zod": "^4.3.6"
|
|
52
|
+
"@modelcontextprotocol/sdk": "^1.12.1"
|
|
72
53
|
},
|
|
73
54
|
"devDependencies": {
|
|
74
55
|
"@types/node": "^22.0.0",
|
|
75
56
|
"tsx": "^4.21.0",
|
|
76
|
-
"typescript": "^5.8.0"
|
|
77
|
-
"yaml": "^2.8.3"
|
|
57
|
+
"typescript": "^5.8.0"
|
|
78
58
|
}
|
|
79
59
|
}
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Runtime query layer over the unified Capability index (N1 Phase 3).
|
|
3
|
-
*
|
|
4
|
-
* Loads the build-time snapshot at `./capabilities.generated.json` (built by
|
|
5
|
-
* `mcp/scripts/build-capabilities.mjs` from `data/capabilities/*.yml`) and
|
|
6
|
-
* exposes a small functional API for the MCP server tools.
|
|
7
|
-
*
|
|
8
|
-
* The snapshot is validated through the Zod Capability schema **once at
|
|
9
|
-
* module import**. Per-call validation would burn CPU on every tool
|
|
10
|
-
* invocation; one-shot validation at startup catches schema/data drift
|
|
11
|
-
* before the server handles its first request.
|
|
12
|
-
*
|
|
13
|
-
* The MCP server runs on the user's machine, not on AWS. Bundling the
|
|
14
|
-
* snapshot keeps that path AWS-credentialless. DynamoDB is the runtime
|
|
15
|
-
* backing store for the FastAPI side (Hugo build, web visitors, future
|
|
16
|
-
* Costco gateway) — both consumers read from `data/capabilities/*.yml`
|
|
17
|
-
* as the canonical source.
|
|
18
|
-
*/
|
|
19
|
-
import { Capability } from "../types/capability.js";
|
|
20
|
-
/** Return every Capability in the index. Order is YAML filename ascending. */
|
|
21
|
-
export declare function listAllCapabilities(): readonly Capability[];
|
|
22
|
-
/** Fetch one Capability by stable slug, or undefined if absent. */
|
|
23
|
-
export declare function getCapability(id: string): Capability | undefined;
|
|
24
|
-
/** All Capabilities of a single element_type. */
|
|
25
|
-
export declare function listCapabilitiesByElementType(elementType: Capability["element_type"]): readonly Capability[];
|
|
26
|
-
/** Capabilities matching any of the given jtbd_tags (OR semantics). Used by
|
|
27
|
-
* the find_capability tool's task-first query path. */
|
|
28
|
-
export declare function findCapabilitiesByJtbd(tags: readonly string[]): Capability[];
|
|
29
|
-
/** Capabilities matching any of the given category strings. /service/<cat>/
|
|
30
|
-
* list views and the legacy `list_services` tool route through here. */
|
|
31
|
-
export declare function listCapabilitiesByCategory(category: string): Capability[];
|
|
32
|
-
/** Total count — exposed for diagnostics + the homepage's dynamic
|
|
33
|
-
* service-count display. */
|
|
34
|
-
export declare function capabilityCount(): number;
|