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.
Files changed (47) hide show
  1. package/dist/about.d.ts +10 -0
  2. package/dist/about.js +16 -0
  3. package/dist/server.js +6 -20
  4. package/package.json +13 -33
  5. package/dist/data/capabilities.d.ts +0 -34
  6. package/dist/data/capabilities.generated.json +0 -32176
  7. package/dist/data/capabilities.js +0 -62
  8. package/dist/data/event-sources.d.ts +0 -47
  9. package/dist/data/event-sources.js +0 -125
  10. package/dist/data/pricing.d.ts +0 -1
  11. package/dist/data/pricing.js +0 -582
  12. package/dist/data/recommendations.d.ts +0 -1
  13. package/dist/data/recommendations.js +0 -2350
  14. package/dist/data/risks.d.ts +0 -1
  15. package/dist/data/risks.js +0 -366
  16. package/dist/data/solve.d.ts +0 -43
  17. package/dist/data/solve.js +0 -362
  18. package/dist/telemetry.d.ts +0 -64
  19. package/dist/telemetry.js +0 -99
  20. package/dist/tools/analytics.d.ts +0 -8
  21. package/dist/tools/analytics.js +0 -54
  22. package/dist/tools/compare-capabilities.d.ts +0 -35
  23. package/dist/tools/compare-capabilities.js +0 -101
  24. package/dist/tools/compatibility.d.ts +0 -16
  25. package/dist/tools/compatibility.js +0 -245
  26. package/dist/tools/find-capability.d.ts +0 -58
  27. package/dist/tools/find-capability.js +0 -161
  28. package/dist/tools/get-capability.d.ts +0 -21
  29. package/dist/tools/get-capability.js +0 -22
  30. package/dist/tools/invoke-capability.d.ts +0 -45
  31. package/dist/tools/invoke-capability.js +0 -109
  32. package/dist/tools/list-capabilities.d.ts +0 -39
  33. package/dist/tools/list-capabilities.js +0 -50
  34. package/dist/tools/list.d.ts +0 -23
  35. package/dist/tools/list.js +0 -106
  36. package/dist/tools/pricing.d.ts +0 -5
  37. package/dist/tools/pricing.js +0 -29
  38. package/dist/tools/recommend.d.ts +0 -42
  39. package/dist/tools/recommend.js +0 -331
  40. package/dist/tools/risks.d.ts +0 -5
  41. package/dist/tools/risks.js +0 -14
  42. package/dist/tools/setup.d.ts +0 -30
  43. package/dist/tools/setup.js +0 -316
  44. package/dist/tools/solve.d.ts +0 -31
  45. package/dist/tools/solve.js +0 -126
  46. package/dist/types/capability.d.ts +0 -276
  47. package/dist/types/capability.js +0 -191
@@ -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.0",
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
- // Tool: about_auxiliar
20
- 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 () => {
21
- const info = {
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.0",
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:data": "node --import tsx scripts/build-capabilities.mjs",
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
- "clawhub",
34
- "ocr",
35
- "pdf",
36
- "pdf-extraction",
37
- "pdf-ocr",
38
- "document-ai",
39
- "invoice-extraction",
40
- "nfs-e",
41
- "boleto",
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;