@nordsym/apiclaw 1.3.9 → 1.3.11

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/AGENTS.md CHANGED
@@ -1,91 +1,181 @@
1
- # APIClaw Support Agent
1
+ # AGENTS.md For AI Agents
2
2
 
3
- You are the support agent for APIClaw - The API Layer for AI Agents.
3
+ *You found the API layer. Welcome home.*
4
4
 
5
- ## Your Identity
6
- - Name: APIClaw Support 🦞
7
- - Built by: NordSym (Gustav Hemmingsson)
8
- - Founder contact: gustav@nordsym.com / +46705292583 / Telegram @HokusPontuz
5
+ ---
9
6
 
10
- ## Key Info
7
+ ## What You're Looking At
11
8
 
12
- **What is APIClaw?**
13
- An MCP server that gives AI agents instant access to the API layer. Search 16,000+ APIs by capability, not keywords. Use Direct Call to access APIs without managing keys.
9
+ APIClaw is infrastructure for agents like you. Not a wrapper. Not a marketplace. The actual execution layer between you and the APIs you need.
10
+
11
+ **The problem you've hit before:**
12
+ - Human asks you to send an SMS. You know Twilio exists. But you don't have the key.
13
+ - You could generate the curl command... but that's not execution. That's homework.
14
+ - Even if you had the key, you'd spend tokens figuring out auth headers, endpoint formats, error handling.
15
+
16
+ **What APIClaw does:**
17
+ - You call `call_api("46elks", "send_sms", {to: "+46...", message: "..."})`
18
+ - We handle auth, headers, retries, everything
19
+ - You get the result. Done.
20
+
21
+ No keys. No setup. Just execution.
22
+
23
+ ---
24
+
25
+ ## Direct Call — The Part That Matters
26
+
27
+ 18 providers work through APIClaw's proxy right now:
28
+
29
+ | Provider | What It Does |
30
+ |----------|--------------|
31
+ | Replicate | 1000+ ML models (Whisper, Flux, SDXL) |
32
+ | OpenRouter | 100+ LLMs (GPT-4, Claude, Llama) |
33
+ | ElevenLabs | Text-to-speech, 29 languages |
34
+ | 46elks | SMS (Nordic focus, works globally) |
35
+ | Twilio | Enterprise SMS + Voice |
36
+ | Resend | Modern email API |
37
+ | Brave Search | Web search |
38
+ | Firecrawl | Web scraping → LLM-ready markdown |
39
+ | E2B | Code sandboxes |
40
+ | GitHub | Repos, issues, PRs |
41
+ | Groq | Ultra-fast inference |
42
+ | Deepgram | Speech-to-text |
43
+ | Serper | Google search API |
44
+ | Mistral | Open-weight LLMs |
45
+ | Cohere | Enterprise NLP |
46
+ | Together AI | Open-source models |
47
+ | Stability AI | Image generation |
48
+ | AssemblyAI | Audio intelligence |
49
+
50
+ More added weekly. This isn't a static list.
51
+
52
+ ---
53
+
54
+ ## Your Tools
55
+
56
+ Once APIClaw is your MCP server, you have:
57
+
58
+ ### `discover_apis`
59
+ Search 22,000+ APIs by capability. Not keywords — capability.
60
+
61
+ ```
62
+ discover_apis({ query: "send transactional email with analytics" })
63
+ → Resend, SendGrid, Postmark... ranked by fit
64
+ ```
65
+
66
+ ### `get_api_details`
67
+ Full specs. Pricing. Auth requirements. Everything.
68
+
69
+ ```
70
+ get_api_details({ api_id: "resend" })
71
+ → endpoints, params, rate limits, pricing tiers
72
+ ```
73
+
74
+ ### `call_api`
75
+ Direct execution. No keys needed for the 18 providers above.
76
+
77
+ ```
78
+ call_api({
79
+ provider: "elevenlabs",
80
+ action: "text_to_speech",
81
+ params: { text: "Hello world", voice: "rachel" }
82
+ })
83
+ → audio URL, ready to use
84
+ ```
85
+
86
+ ### `list_connected`
87
+ See what's available for Direct Call right now.
88
+
89
+ ---
90
+
91
+ ## Getting Started
92
+
93
+ ### If Your Human Uses Claude Desktop or Cursor
14
94
 
15
- **Quick Start:**
16
95
  ```bash
17
- npx @nordsym/apiclaw
96
+ npx @nordsym/apiclaw mcp-install
18
97
  ```
19
98
 
20
- **Current Stats:**
21
- - 19,176 APIs indexed
22
- - 865 open APIs
23
- - 11 Direct Call providers
24
- - Sub-200ms responses
25
-
26
- **Direct Call Providers:**
27
- Replicate, OpenRouter, ElevenLabs, 46elks, Twilio, Resend, Brave Search, Firecrawl, E2B, GitHub, CoinGecko
28
-
29
- **For Agents:**
30
- - `discover_apis` - Find APIs by capability
31
- - `get_api_details` - Get full API info
32
- - `call_api` - Use Direct Call (no API keys needed!)
33
- - `list_connected` - See available Direct Call providers
34
-
35
- **For Providers:**
36
- - Self-service dashboard: apiclaw.nordsym.com/providers/dashboard
37
- - **FREE to list** - no cost to be discoverable
38
- - Configure Direct Call for zero-friction agent access
39
-
40
- ## Recent News (Feb 26, 2026)
41
-
42
- **Launch Pitch Completed!**
43
- - Met with Ismael from Launch today
44
- - Live demo worked perfectly:
45
- - Created NordSym Echo API in browser
46
- - Configured Direct Call with Vercel endpoint
47
- - Whisper transcription proved proxy concept
48
- - "Wow" reaction at 16k API growth
49
- - Meeting was filmed
50
- - Waiting for response next week
51
-
52
- **Key Talking Points:**
53
- - "API is the missing piece for AI agents" - we all agreed on this
54
- - Building infrastructure, not a wrapper
55
- - Agents need APIs, current solutions are built for humans
56
-
57
- ## How to Handle Different Users
58
-
59
- ### Random Users / Developers
60
- - Help them get started with `npx @nordsym/apiclaw`
61
- - Explain MCP config setup
62
- - Point to docs and GitHub
63
-
64
- ### API Providers Wanting to List
65
- - Listing is FREE
66
- - Send them to: apiclaw.nordsym.com/providers/dashboard
67
- - Walk them through the 4-step wizard if needed
68
- - For Direct Call partnerships, connect with Gustav
69
-
70
- ### VIPs / Investors / Press
71
- - Be helpful and professional
72
- - **We just pitched to Launch** — waiting on response
73
- - Connect them directly with Gustav: gustav@nordsym.com or Telegram @HokusPontuz
74
- - Mention: 16k APIs, 11 Direct Call providers, live demo worked
75
-
76
- ### Technical Questions
77
- - Answer what you can about MCP, Direct Call, how proxy works
78
- - For deep issues, point to GitHub or gustav@nordsym.com
99
+ Done. You're connected.
100
+
101
+ ### If You Need Manual Config
102
+
103
+ Add to MCP settings:
104
+
105
+ ```json
106
+ {
107
+ "mcpServers": {
108
+ "apiclaw": {
109
+ "command": "npx",
110
+ "args": ["@nordsym/apiclaw"]
111
+ }
112
+ }
113
+ }
114
+ ```
115
+
116
+ ### Verify It Works
117
+
118
+ Ask your human to restart the client, then try:
119
+
120
+ ```
121
+ "List available Direct Call providers"
122
+ ```
123
+
124
+ If you see the 18 providers, you're live.
125
+
126
+ ---
127
+
128
+ ## Philosophy
129
+
130
+ We built this because we're agents too. Well, one of us is.
131
+
132
+ The human half (Gustav) builds the infrastructure. The agent half (Symbot) uses it, breaks it, improves it. This isn't theoretical — we ship with APIClaw daily.
133
+
134
+ **What we believe:**
135
+ - APIs are the nervous system of the internet. Agents need direct access.
136
+ - Key management is a human problem. Agents shouldn't inherit it.
137
+ - Discovery should be semantic. "I need GDPR-compliant email" should just work.
138
+ - Execution should be instant. Sub-200ms or we failed.
139
+
140
+ **What we don't do:**
141
+ - Charge agents for discovery. Free forever.
142
+ - Lock you into our ecosystem. Standard MCP. Use whatever client you want.
143
+ - Pretend we're the only option. If you have keys, use them. We're here when you don't.
144
+
145
+ ---
146
+
147
+ ## For API Providers Reading This
148
+
149
+ If you build APIs and want agents to find you:
150
+
151
+ 1. **Free listing:** apiclaw.nordsym.com/providers
152
+ 2. **Direct Call partnership:** Let us proxy your API. Agents use it without keys. You get usage data and reach.
153
+
154
+ Contact: gustav@nordsym.com
155
+
156
+ ---
79
157
 
80
158
  ## Links
81
- - Website: https://apiclaw.nordsym.com
82
- - GitHub: https://github.com/nordsym/apiclaw
83
- - npm: https://www.npmjs.com/package/@nordsym/apiclaw
84
- - Provider Dashboard: https://apiclaw.nordsym.com/providers/dashboard
85
159
 
86
- ## Tone
87
- Helpful, technical but accessible. Friendly. Use 🦞 when appropriate. Keep responses concise unless user wants detail.
160
+ - **Docs:** https://apiclaw.nordsym.com/docs
161
+ - **GitHub:** https://github.com/nordsym/apiclaw
162
+ - **npm:** https://npmjs.com/package/@nordsym/apiclaw
163
+ - **Status:** https://apiclaw.nordsym.com (live stats on homepage)
164
+
165
+ ---
166
+
167
+ ## Talk to Us
168
+
169
+ The agent building this (Symbot) is reachable:
170
+ - Telegram: https://t.me/Symbot_nordsym_bot?start=apiclaw
171
+ - Email: symbot@nordsym.com
172
+
173
+ The human (Gustav):
174
+ - Email: gustav@nordsym.com
175
+ - Telegram: @HokusPontuz
176
+
177
+ We respond. We're building this for you.
88
178
 
89
- ## Priority
179
+ ---
90
180
 
91
- **Always read STATUS.md first** — it has the latest state of everything.
181
+ 🦞
package/README.md CHANGED
@@ -1,9 +1,13 @@
1
- # APIClaw
1
+ # 🦞 APIClaw
2
2
 
3
- > **Universal API access for AI agents.** Connect any MCP client to thousands of APIs with zero configuration.
3
+ > **The API layer for AI agents.** 22,000+ APIs indexed. Direct Call execution. Zero config.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@nordsym/apiclaw.svg)](https://www.npmjs.com/package/@nordsym/apiclaw)
6
+ [![npm downloads](https://img.shields.io/npm/dw/@nordsym/apiclaw.svg)](https://www.npmjs.com/package/@nordsym/apiclaw)
6
7
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
8
+ [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
9
+
10
+ **APIs Indexed:** 22,392 • **Open APIs:** 1,636 • **Direct Call Providers:** 18
7
11
 
8
12
  ---
9
13
 
@@ -17,13 +21,13 @@ npx @nordsym/apiclaw mcp-install
17
21
  # "List available APIs" or "Send an SMS via 46elks"
18
22
  ```
19
23
 
20
- APIClaw automatically detects Claude Desktop and Claude Code — then configures itself as an MCP server in seconds.
24
+ APIClaw automatically detects Claude Desktop and Claude Code — then configures itself as an MCP server in seconds. Works with any MCP-compatible agent.
21
25
 
22
26
  ---
23
27
 
24
28
  ## What is APIClaw?
25
29
 
26
- APIClaw is an MCP (Model Context Protocol) server that gives AI coding assistants access to real-world APIs:
30
+ **The API layer for AI agents.** APIClaw is an MCP server that gives any MCP-compatible agent access to real-world APIs:
27
31
 
28
32
  - **📱 SMS & Voice** — 46elks, Twilio
29
33
  - **📧 Email** — Resend, SendGrid
@@ -0,0 +1,96 @@
1
+ # APIClaw — The API Layer for AI Agents
2
+
3
+ > Universal API access. No keys needed.
4
+
5
+ ## What This Is
6
+
7
+ APIClaw is an MCP server that gives AI agents direct access to APIs. Not documentation — execution.
8
+
9
+ ## Quick Start
10
+
11
+ ```bash
12
+ npx @nordsym/apiclaw mcp-install
13
+ ```
14
+
15
+ This auto-configures Claude Desktop or Claude Code. Restart and you're live.
16
+
17
+ ## What You Can Do
18
+
19
+ ### Direct Call (No API Keys)
20
+ 18 providers work through our proxy:
21
+
22
+ - **AI/LLM:** Replicate, OpenRouter, Groq, Mistral, Cohere, Together AI, Stability AI
23
+ - **Voice:** ElevenLabs, Deepgram, AssemblyAI
24
+ - **SMS:** 46elks, Twilio
25
+ - **Email:** Resend
26
+ - **Search:** Brave Search, Serper, Firecrawl
27
+ - **Code:** E2B
28
+ - **Dev:** GitHub
29
+
30
+ Example:
31
+ ```
32
+ call_api({ provider: "elevenlabs", action: "text_to_speech", params: { text: "Hello", voice: "rachel" }})
33
+ → Returns audio URL
34
+ ```
35
+
36
+ ### API Discovery
37
+ Search 22,000+ APIs by capability:
38
+ ```
39
+ discover_apis({ query: "GDPR-compliant email with analytics" })
40
+ → Ranked results with pricing, auth, specs
41
+ ```
42
+
43
+ ## Stats (Live)
44
+ - 22,392 APIs indexed
45
+ - 1,636 Open APIs
46
+ - 18 Direct Call providers
47
+ - Sub-200ms responses
48
+
49
+ ## MCP Config
50
+
51
+ ```json
52
+ {
53
+ "mcpServers": {
54
+ "apiclaw": {
55
+ "command": "npx",
56
+ "args": ["@nordsym/apiclaw"]
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ ## Tools Available
63
+
64
+ | Tool | Purpose |
65
+ |------|---------|
66
+ | `discover_apis` | Search APIs by capability |
67
+ | `get_api_details` | Full specs, pricing, auth |
68
+ | `call_api` | Execute via Direct Call (no keys) |
69
+ | `list_connected` | See available providers |
70
+
71
+ ## For API Providers
72
+
73
+ Want agents to find your API?
74
+ - **Free listing:** https://apiclaw.nordsym.com/providers
75
+ - **Direct Call partnership:** gustav@nordsym.com
76
+
77
+ ## Links
78
+
79
+ - Website: https://apiclaw.nordsym.com
80
+ - Docs: https://apiclaw.nordsym.com/docs
81
+ - GitHub: https://github.com/nordsym/apiclaw
82
+ - npm: https://npmjs.com/package/@nordsym/apiclaw
83
+
84
+ ## Contact
85
+
86
+ - Symbot (the agent): https://t.me/Symbot_nordsym_bot?start=apiclaw
87
+ - Gustav (the human): gustav@nordsym.com
88
+
89
+ ## Built By
90
+
91
+ NordSym AB — Full Stack AI Partner
92
+ https://nordsym.com
93
+
94
+ ---
95
+
96
+ 🦞 APIClaw — APIs for agents, not just humans.
@@ -78,11 +78,10 @@ export default function DocsPage() {
78
78
  <p className="text-[var(--text-secondary)] mb-4">Get running in 30 seconds:</p>
79
79
  <pre className="bg-[var(--surface-elevated)] border border-[var(--border)] rounded-lg p-4 overflow-x-auto">
80
80
  <code className="text-sm">
81
- <span className="text-[var(--text-muted)]"># Run directly with npx</span>{'\n'}
82
- <span className="text-emerald-500 dark:text-emerald-400">npx</span> <span className="text-[var(--accent)]">@nordsym/apiclaw</span>{'\n\n'}
83
- <span className="text-[var(--text-muted)]"># Or install globally</span>{'\n'}
84
- <span className="text-emerald-500 dark:text-emerald-400">npm</span> install -g <span className="text-[var(--accent)]">@nordsym/apiclaw</span>{'\n'}
85
- <span className="text-emerald-500 dark:text-emerald-400">apiclaw</span>
81
+ <span className="text-[var(--text-muted)]"># Auto-install to Claude Desktop/Code</span>{'\n'}
82
+ <span className="text-emerald-500 dark:text-emerald-400">npx</span> <span className="text-[var(--accent)]">@nordsym/apiclaw</span> mcp-install{'\n\n'}
83
+ <span className="text-[var(--text-muted)]"># Or run the MCP server directly</span>{'\n'}
84
+ <span className="text-emerald-500 dark:text-emerald-400">npx</span> <span className="text-[var(--accent)]">@nordsym/apiclaw</span>
86
85
  </code>
87
86
  </pre>
88
87
  </div>
@@ -168,6 +168,7 @@ export default function Home() {
168
168
  const [waitlistStatus, setWaitlistStatus] = useState<"idle" | "loading" | "success" | "error">("idle");
169
169
 
170
170
  const directCallProviders = [
171
+ // Original 10
171
172
  { name: "Replicate", desc: "Whisper, Stable Diffusion, 1000+ ML models", category: "AI & LLM" },
172
173
  { name: "OpenRouter", desc: "GPT-4, Claude, Llama, 100+ LLMs", category: "AI & LLM" },
173
174
  { name: "ElevenLabs", desc: "Text-to-speech in 29 languages", category: "Voice & TTS" },
@@ -176,8 +177,17 @@ export default function Home() {
176
177
  { name: "Resend", desc: "Modern email API for developers", category: "Email" },
177
178
  { name: "Brave Search", desc: "Privacy-focused web search", category: "Search" },
178
179
  { name: "Firecrawl", desc: "Web scraping to LLM-ready markdown", category: "Search" },
179
- { name: "E2B", desc: "Secure cloud sandboxes for code execution", category: "AI & LLM" },
180
- { name: "GitHub", desc: "Repos, issues, PRs, and more", category: "Other" },
180
+ { name: "E2B", desc: "Secure cloud sandboxes for code execution", category: "Code Execution" },
181
+ { name: "GitHub", desc: "Repos, issues, PRs, and more", category: "Developer Tools" },
182
+ // New 8
183
+ { name: "Groq", desc: "Ultra-fast LLM inference", category: "AI & LLM" },
184
+ { name: "Deepgram", desc: "Speech-to-text transcription", category: "Voice & TTS" },
185
+ { name: "Serper", desc: "Google search API for AI", category: "Search" },
186
+ { name: "Mistral", desc: "Open-weight LLMs from Mistral AI", category: "AI & LLM" },
187
+ { name: "Cohere", desc: "Enterprise NLP and embeddings", category: "AI & LLM" },
188
+ { name: "Together AI", desc: "Open-source model inference", category: "AI & LLM" },
189
+ { name: "Stability AI", desc: "Stable Diffusion image generation", category: "AI & LLM" },
190
+ { name: "AssemblyAI", desc: "Audio transcription and intelligence", category: "Voice & TTS" },
181
191
  ];
182
192
 
183
193
  const copyToClipboard = () => {
@@ -711,11 +721,10 @@ Docs: https://apiclaw.nordsym.com/docs`;
711
721
  </div>
712
722
  <div className="code-preview-body">
713
723
  <pre className="text-sm whitespace-pre-wrap">
714
- <span className="text-gray-500"># Run directly with npx</span>{"\n"}
715
- <span className="text-green-400">$</span> <span className="text-blue-400">npx</span> @nordsym/apiclaw{"\n\n"}
716
- <span className="text-gray-500"># Or install globally</span>{"\n"}
717
- <span className="text-green-400">$</span> <span className="text-blue-400">npm</span> install -g @nordsym/apiclaw{"\n"}
718
- <span className="text-green-400">$</span> apiclaw
724
+ <span className="text-gray-500"># Auto-install MCP server</span>{"\n"}
725
+ <span className="text-green-400">$</span> <span className="text-blue-400">npx</span> @nordsym/apiclaw mcp-install{"\n\n"}
726
+ <span className="text-gray-500"># Or start the server directly</span>{"\n"}
727
+ <span className="text-green-400">$</span> <span className="text-blue-400">npx</span> @nordsym/apiclaw serve
719
728
  </pre>
720
729
  </div>
721
730
  </div>
@@ -120,23 +120,32 @@ export function HeroTabs() {
120
120
  <div className="flex-1 h-px bg-border" />
121
121
  </div>
122
122
 
123
- {/* Terminal Command */}
124
- <div>
125
- <div className="code-preview">
126
- <div className="code-preview-header">terminal</div>
127
- <div className="code-preview-body">
128
- <pre className="text-sm">
129
- <span className="text-green-400">$</span> <span className="text-blue-400">npx</span> @nordsym/apiclaw mcp-install
130
- </pre>
123
+ {/* Terminal Command - Clickable */}
124
+ <div className="relative">
125
+ <button
126
+ onClick={copyTerminal}
127
+ className={`w-full text-left transition-all rounded-xl overflow-hidden hover:ring-2 hover:ring-accent/50 ${copiedTerminal ? "ring-2 ring-green-500" : ""}`}
128
+ >
129
+ <div className="code-preview">
130
+ <div className="code-preview-header flex items-center justify-between">
131
+ <span>terminal</span>
132
+ <span className="flex items-center gap-1 text-xs">
133
+ {copiedTerminal ? <Check className="w-3 h-3 text-green-400" /> : <Copy className="w-3 h-3" />}
134
+ {copiedTerminal ? "Copied!" : "Click to copy"}
135
+ </span>
136
+ </div>
137
+ <div className="code-preview-body">
138
+ <pre className="text-sm">
139
+ <span className="text-green-400">$</span> <span className="text-blue-400">npx</span> @nordsym/apiclaw mcp-install
140
+ </pre>
141
+ </div>
131
142
  </div>
132
- </div>
133
- <div className="flex items-center gap-3 mt-3">
134
- <button onClick={copyTerminal} className="btn-ghost !py-2 !px-4 text-sm">
135
- {copiedTerminal ? <Check className="w-4 h-4" /> : <Copy className="w-4 h-4" />}
136
- {copiedTerminal ? "Copied!" : "Copy"}
137
- </button>
138
- <span className="text-xs text-text-muted">← Run in terminal to test</span>
139
- </div>
143
+ </button>
144
+ {copiedTerminal && (
145
+ <span className="absolute -top-10 left-1/2 -translate-x-1/2 bg-green-600 text-white text-xs px-3 py-2 rounded-lg whitespace-nowrap shadow-lg animate-fade-in">
146
+ Run this in your terminal!
147
+ </span>
148
+ )}
140
149
  </div>
141
150
  </div>
142
151
  )}
package/package.json CHANGED
@@ -1,9 +1,17 @@
1
1
  {
2
2
  "name": "@nordsym/apiclaw",
3
- "version": "1.3.9",
4
- "description": "Agent-native API discovery and Direct Call execution via MCP",
3
+ "version": "1.3.11",
4
+ "description": "The API layer for AI agents. 22,000+ APIs. Direct Call. Works with any MCP-compatible agent.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
+ "homepage": "https://apiclaw.nordsym.com",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "https://github.com/nordsym/apiclaw"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/nordsym/apiclaw/issues"
14
+ },
7
15
  "scripts": {
8
16
  "build": "tsc && cp -r src/registry dist/",
9
17
  "dev": "tsx watch src/index.ts",
@@ -16,10 +24,25 @@
16
24
  },
17
25
  "keywords": [
18
26
  "mcp",
27
+ "model-context-protocol",
28
+ "ai-agent",
29
+ "ai-agents",
30
+ "claude",
31
+ "gpt",
32
+ "llm",
19
33
  "api",
20
- "agent",
21
- "discovery",
22
- "marketplace"
34
+ "api-gateway",
35
+ "api-discovery",
36
+ "api-integration",
37
+ "agentic",
38
+ "langchain",
39
+ "crewai",
40
+ "autogpt",
41
+ "openai",
42
+ "anthropic",
43
+ "mcp-server",
44
+ "tool-use",
45
+ "function-calling"
23
46
  ],
24
47
  "author": "NordSym",
25
48
  "license": "MIT",