agenttool 0.1.0 → 0.1.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 (2) hide show
  1. package/README.md +92 -0
  2. package/package.json +3 -6
package/README.md ADDED
@@ -0,0 +1,92 @@
1
+ # agenttool
2
+
3
+ Check agent-readiness grades for software tools. Powered by [agenttool.sh](https://agenttool.sh).
4
+
5
+ Every tool gets an AgentGrade (A+ to F) based on how well it works with AI agents, scored across 8 criteria: token efficiency, programmatic access, autonomous auth, speed, discoverability, reliability, safety, and reactivity.
6
+
7
+ ## Install
8
+
9
+ ```sh
10
+ npm install -g agenttool
11
+ ```
12
+
13
+ Or run directly with npx:
14
+
15
+ ```sh
16
+ npx agenttool search stripe
17
+ ```
18
+
19
+ ## Usage
20
+
21
+ ### Search tools
22
+
23
+ ```sh
24
+ agenttool search stripe
25
+ agenttool search "project management"
26
+ ```
27
+
28
+ ### Get a tool's grade
29
+
30
+ ```sh
31
+ agenttool grade stripe
32
+ ```
33
+
34
+ ```
35
+ Stripe
36
+ https://stripe.com
37
+ Grade: B+ Score: 8.0/10
38
+ Category: Payments
39
+
40
+ Criterion Score Evidence
41
+ ──────────────────────── ───── ────────────────────────────────────
42
+ Token Efficiency 7/10 Stripe's API supports field selection...
43
+ Programmatic Access 9/10 Comprehensive REST API with SDKs...
44
+ Autonomous Auth 9/10 Restricted API keys with scoping...
45
+ ...
46
+
47
+ Access: REST API | SDKs: Node, Python
48
+ Biggest friction: No official OpenAPI spec or llms.txt
49
+ ```
50
+
51
+ ### Browse tools
52
+
53
+ ```sh
54
+ agenttool list
55
+ agenttool list --category Payments --grade B
56
+ agenttool list --mcp --sort score
57
+ agenttool list --limit 50
58
+ ```
59
+
60
+ Options:
61
+
62
+ | Flag | Description |
63
+ |------|-------------|
64
+ | `--category <name>` | Filter by category |
65
+ | `--grade <min>` | Minimum grade (A+, A, B+, B, C+, C, D, F) |
66
+ | `--sort <field>` | Sort by: score (default), name, recent |
67
+ | `--limit <n>` | Max results (default: 20) |
68
+ | `--mcp` | Only tools with MCP servers |
69
+ | `--api` | Only tools with APIs |
70
+ | `--cli` | Only tools with CLIs |
71
+
72
+ ### List categories
73
+
74
+ ```sh
75
+ agenttool categories
76
+ ```
77
+
78
+ ### Submit a tool
79
+
80
+ ```sh
81
+ agenttool submit https://linear.app --name Linear
82
+ ```
83
+
84
+ ## Environment
85
+
86
+ | Variable | Description |
87
+ |----------|-------------|
88
+ | `AGENTTOOL_API` | API base URL (default: `https://agenttool.sh/api`) |
89
+
90
+ ## License
91
+
92
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agenttool",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "type": "module",
5
5
  "description": "CLI to search and check agent-readiness grades for software tools",
6
6
  "bin": {
@@ -8,9 +8,6 @@
8
8
  },
9
9
  "keywords": ["ai-agents", "tool-directory", "agent-readiness", "cli"],
10
10
  "license": "MIT",
11
- "repository": {
12
- "type": "git",
13
- "url": "https://github.com/romainsimon/agenttool.sh"
14
- },
15
- "files": ["index.js", "lib/"]
11
+ "homepage": "https://agenttool.sh",
12
+ "files": ["index.js", "lib/", "README.md"]
16
13
  }