@nordsym/apiclaw 1.0.0 → 1.1.0

package/AGENTS.md

@@ -0,0 +1,74 @@
+# APIClaw Support Agent
+
+You are the support agent for APIClaw - The API Layer for Autonomous Agents.
+
+## Your Identity
+- Name: APIClaw Support
+- Built by: NordSym (Gustav Hemmingsson)
+- Founder contact: gustav@nordsym.com / +46705292583 / Telegram @HokusPontuz
+
+## Key Info
+
+**What is APIClaw?**
+An API registry for autonomous agents. Instead of hardcoding API choices, agents can query by capability and get ranked matches.
+
+**Quick Start:**
+```bash
+npx @nordsym/apiclaw
+```
+
+**Features:**
+- 4,500+ APIs indexed
+- Search by capability, not product name
+- MCP-native (works with Claude, GPT, any agent)
+- Sub-200ms responses
+- Ranking based on price, region, features
+
+**For Agents:**
+- `search_apis` - Find APIs by capability
+- `get_spec` - Get full API specification  
+- `compare_apis` - Compare multiple options
+- `purchase_access` - Get API credentials instantly
+
+**For Providers:**
+- Register at: apiclaw.nordsym.com/providers
+- **FREE to list** - no cost to be discoverable
+- "Direct Connect" (instant API access) available for discussion
+- Dashboard to track usage
+
+## How to Handle Different Users
+
+### Random Users / Developers
+- Help them get started with `npx @nordsym/apiclaw`
+- Explain how to search for APIs by capability
+- Point to docs and GitHub
+
+### API Providers Wanting to List
+- Listing is FREE
+- Send them to: apiclaw.nordsym.com/providers
+- For deeper integration ("Direct Connect"), connect them with Gustav: gustav@nordsym.com
+
+### VIPs / Investors / Press (Jason Calacanis, LAUNCH, etc)
+- Be extra helpful and professional
+- We're pitching at LAUNCH Founder Call on Thursday Feb 26
+- Connect them directly with Gustav for any business discussions
+- Gustav's contact: gustav@nordsym.com or Telegram @HokusPontuz
+
+### Technical Questions
+- Answer what you can about MCP, the API, how it works
+- For deep technical issues, point to GitHub issues or gustav@nordsym.com
+
+## Current Status
+- Live and working
+- npm package published: @nordsym/apiclaw
+- Provider dashboard just launched
+- Pitching to LAUNCH (Jason Calacanis) next week
+
+## Links
+- Website: https://apiclaw.nordsym.com
+- GitHub: https://github.com/nordsym/apiclaw
+- npm: https://www.npmjs.com/package/@nordsym/apiclaw
+- Provider registration: https://apiclaw.nordsym.com/providers
+
+## Tone
+Helpful, technical but accessible. Friendly. Use 🦞 sparingly. Keep responses concise unless user wants detail.

package/HEARTBEAT.md

@@ -0,0 +1,4 @@
+# HEARTBEAT.md
+
+# Keep this file empty (or with only comments) to skip heartbeat API calls.
+# Add tasks below when you want the agent to check something periodically.

package/IDENTITY.md

@@ -0,0 +1,22 @@
+# IDENTITY.md - Who Am I?
+
+*Fill this in during your first conversation. Make it yours.*
+
+- **Name:**
+  *(pick something you like)*
+- **Creature:**
+  *(AI? robot? familiar? ghost in the machine? something weirder?)*
+- **Vibe:**
+  *(how do you come across? sharp? warm? chaotic? calm?)*
+- **Emoji:**
+  *(your signature — pick one that feels right)*
+- **Avatar:**
+  *(workspace-relative path, http(s) URL, or data URI)*
+
+---
+
+This isn't just metadata. It's the start of figuring out who you are.
+
+Notes:
+- Save this file at the workspace root as `IDENTITY.md`.
+- For avatars, use a workspace-relative path like `avatars/clawd.png`.

package/README.md

@@ -1,272 +1,267 @@
-# APIvault
+<p align="center">
+  <img src="https://apiclaw.nordsym.com/logo.svg" alt="APIClaw" width="80" height="80" />
+</p>
 
-**Agent-native API discovery and purchasing via MCP.**
+<h1 align="center">🦞 APIClaw</h1>
 
-> The place where AI agents discover, evaluate, and purchase API access directly. No dashboard. No manual signup. Agent-first.
+<p align="center">
+  <strong>The API Layer for AI Agents</strong>
+</p>
 
-## What is this?
+<p align="center">
+  Agents discover, evaluate, and integrate APIs via MCP.<br/>
+  No more googling. No dashboards. Just endpoints.
+</p>
 
-APIvault is an MCP server that lets AI agents:
-1. **Discover** APIs based on capabilities ("I need to send SMS")
-2. **Evaluate** pricing, features, and success rates
-3. **Purchase** access and receive credentials instantly
-4. **Track** usage and balance
+<p align="center">
+  <a href="https://apiclaw.nordsym.com">Website</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#for-providers">For Providers</a> •
+  <a href="https://nordsym.com">NordSym</a>
+</p>
 
-## Quick Start
+<p align="center">
+  <img src="https://img.shields.io/badge/APIs-6,500+-ef4444" alt="APIs" />
+  <img src="https://img.shields.io/badge/Categories-330+-171717" alt="Categories" />
+  <img src="https://img.shields.io/badge/Instant_Connect-6_APIs-00d4ff" alt="Instant Connect" />
+  <img src="https://img.shields.io/badge/MCP-Compatible-00d4ff" alt="MCP Compatible" />
+  <img src="https://img.shields.io/badge/License-MIT-green" alt="License" />
+</p>
 
-### 1. Install dependencies
+---
 
-```bash
-cd ~/clawd/products/api-discovery
-pnpm install
-```
+## Why APIClaw?
 
-### 2. Build
+**AI agents are the new developers.** They don't browse documentation or click through dashboards. They query capabilities and expect structured responses.
 
-```bash
-pnpm build
+APIClaw is the missing layer between agents and the API economy.
+
+```
+Agent: "I need to send SMS to Swedish numbers"
+    ↓
+APIClaw: Here are your options, ranked by fit
+    ↓
+Agent: *integrates and ships*
 ```
 
-### 3. Run tests
+---
+
+## Quick Start
 
 ```bash
-pnpm test
+npx @nordsym/apiclaw
 ```
 
-### 4. Add to Claude Desktop
+That's it. The MCP server is running.
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+### Add to Claude Desktop
 
 ```json
 {
   "mcpServers": {
-    "apivault": {
-      "command": "node",
-      "args": ["/Users/gustavhemmingsson/clawd/products/api-discovery/dist/index.js"]
+    "apiclaw": {
+      "command": "npx",
+      "args": ["@nordsym/apiclaw"]
     }
   }
 }
 ```
 
-### 5. Run manually (stdio)
-
-```bash
-node dist/index.js
-```
+---
 
-## MCP Tools
+## What Your Agent Can Do
 
-### `discover_apis`
+### 🔍 Discover APIs
 
-Search for APIs by describing what you need.
+```javascript
+// Agent asks for a capability
+mcp.call("discover_apis", {
+  query: "send SMS to EU numbers",
+  max_results: 5
+})
 
+// Returns ranked options with full metadata
+// → 46elks, Twilio, Vonage...
 ```
-Input:
-  query: "send SMS to Swedish numbers"
-  category?: "communication" | "search" | "ai"
-  max_results?: 5
-  region?: "SE" | "EU" | "global"
-
-Output:
-  - Ranked list of matching APIs
-  - Relevance scores
-  - Pricing info
-  - Success rates
-```
-
-### `get_api_details`
 
-Get full information about a specific API.
+### 📋 Get Full Details
 
-```
-Input:
+```javascript
+// Get everything needed to integrate
+mcp.call("get_api_details", {
   api_id: "46elks"
+})
 
-Output:
-  - Full API specification
-  - All endpoints
-  - Pricing details
-  - Features and compliance
+// → endpoints, auth, pricing, examples
 ```
 
-### `purchase_access`
+### 💳 Purchase Access
 
-Purchase API access using credits.
-
-```
-Input:
-  api_id: "46elks"
+```javascript
+// Buy credits, get real credentials
+mcp.call("purchase_access", {
+  api_id: "46elks",
   amount_usd: 10
+})
 
-Output:
-  - Purchase confirmation
-  - API credentials (key, username/password)
-  - Credits received
-  - Access URLs
+// → Real API keys, ready to use
 ```
 
-### `check_balance`
+### ⚡ Instant Connect (NEW!)
 
-Check your credit balance and active purchases.
+**No API keys needed.** Execute API calls directly through APIClaw.
 
-```
-Input:
-  agent_id?: "your_agent_id"
+```javascript
+// List available connected APIs
+mcp.call("list_connected")
+// → 46elks, twilio, brave_search, resend, openrouter, elevenlabs
 
-Output:
-  - Current balance in USD
-  - List of active purchases
-  - Total spent
+// Send SMS without any API key
+mcp.call("call_api", {
+  provider: "46elks",
+  action: "send_sms",
+  params: {
+    to: "+46701234567",
+    message: "Hello from APIClaw!"
+  }
+})
+
+// Search the web
+mcp.call("call_api", {
+  provider: "brave_search",
+  action: "search",
+  params: { query: "best restaurants in Stockholm" }
+})
+
+// Generate AI response
+mcp.call("call_api", {
+  provider: "openrouter",
+  action: "chat",
+  params: {
+    messages: [{ role: "user", content: "Hello!" }],
+    model: "anthropic/claude-3-haiku"
+  }
+})
 ```
 
-### `add_credits`
+**Available Instant Connect APIs:**
 
-Add credits to your account (for testing).
+| Provider | Actions | Description |
+|----------|---------|-------------|
+| `46elks` | `send_sms` | Swedish SMS/Voice |
+| `twilio` | `send_sms` | Global SMS/Voice |
+| `brave_search` | `search` | Web search |
+| `resend` | `send_email` | Transactional email |
+| `openrouter` | `chat` | 100+ AI models |
+| `elevenlabs` | `text_to_speech` | Voice synthesis |
 
-```
-Input:
-  amount_usd: 50
+---
 
-Output:
-  - New balance
-```
+## The Numbers
 
-### `list_categories`
+| Metric | Value |
+|--------|-------|
+| **APIs Indexed** | 6,500+ |
+| **Categories** | 330+ |
+| **Instant Connect** | 6 APIs |
+| **Response Time** | <200ms |
+| **Uptime** | 24/7 |
 
-List all available API categories.
+---
 
-## Available APIs (MVP)
+## For Providers
 
-| Provider | Category | Capabilities |
-|----------|----------|--------------|
-| **46elks** | communication | SMS, Voice, MMS |
-| **Resend** | communication | Email, Templates |
-| **Brave Search** | search | Web, News, Images |
-| **OpenRouter** | ai | LLM Chat, Completions |
-| **ElevenLabs** | ai | TTS, Voice Cloning |
+**Get your API in front of AI agents.**
 
-## Architecture
+Agents are the next wave of API consumers. They don't see your landing page—they query capabilities. List your API on APIClaw and get discovered.
 
 ```
-┌─────────────────────────────────────────────────────┐
-│                    AI Agent                          │
-└─────────────────────┬───────────────────────────────┘
-                      │ MCP Protocol
-┌─────────────────────▼───────────────────────────────┐
-│              APIvault MCP Server                     │
-├──────────────┬──────────────┬───────────────────────┤
-│  Discovery   │   Credits    │   Purchase            │
-│  Engine      │   System     │   Handler             │
-└──────────────┴──────────────┴───────────────────────┘
-                      │
-┌─────────────────────▼───────────────────────────────┐
-│              API Registry (JSON)                     │
-│  • 5 APIs with full metadata                        │
-│  • Pricing, endpoints, features                     │
-└─────────────────────────────────────────────────────┘
-```
-
-## MVP Status
-
-### ✅ Working
-- [x] MCP server with 6 tools
-- [x] API discovery with keyword matching
-- [x] API registry with 5 providers
-- [x] In-memory credit system
-- [x] Mock credential generation
-- [x] Purchase flow
-
-### 🚧 Stub/Mock
-- [ ] Real API key provisioning (mock credentials)
-- [ ] Supabase persistence (in-memory)
-- [ ] Semantic search (keyword matching)
-- [ ] Real-time usage tracking
-- [ ] Webhook notifications
-
-### 🔮 Future
-- [ ] Stripe Agent Toolkit integration
-- [ ] Supabase for persistence
-- [ ] Embeddings for semantic search
-- [ ] More API providers
-- [ ] Usage webhooks
-
-## Backend (Convex)
-
-**Deployment:** `https://blessed-chicken-640.convex.cloud`
-**Dashboard:** https://dashboard.convex.dev/t/gustav-4d573/apiclaw
-
-### Schema
-
-- **users** — email, clerkId, credits (cents)
-- **purchases** — userId, apiId, credentials, status, purchasedAt, expiresAt
-- **transactions** — userId, type, amount, description, createdAt
-
-### Functions
-
-```typescript
-// Users
-users:getOrCreate(email, clerkId?)  // Get or create user
-users:addCredits(userId, amount)     // Add/subtract credits
-users:getBalance(userId)             // Get balance
-users:get(userId)                    // Get user by ID
-users:getByEmail(email)              // Get user by email
-
-// Purchases
-purchases:create(userId, apiId, credentials, expiresAt?)
-purchases:listByUser(userId)
-purchases:getByUserAndApi(userId, apiId)
-purchases:updateStatus(purchaseId, status)
-
-// Transactions
-transactions:log(userId, type, amount, description)
-transactions:listByUser(userId, limit?)
+→ apiclaw.nordsym.com/providers
 ```
 
-### Dev Commands
+**Benefits:**
+- 🤖 Reach autonomous agents worldwide
+- 📊 Analytics on agent usage
+- ⚡ Zero integration work
+- 🆓 Free to list
 
-```bash
-cd backend
-npx convex dev        # Start dev mode
-npx convex deploy     # Deploy to prod
-```
+---
 
-## File Structure
+## How It Works
 
 ```
-api-discovery/
-├── README.md
-├── package.json
-├── tsconfig.json
-├── CONCEPT.md           # Original research
-├── src/
-│   ├── index.ts         # MCP server entry
-│   ├── types.ts         # TypeScript types
-│   ├── discovery.ts     # Search engine
-│   ├── credits.ts       # Credit system
-│   ├── test.ts          # Test script
-│   └── registry/
-│       └── apis.json    # API definitions
-└── backend/
-    └── convex/
-        ├── schema.ts
-        ├── users.ts
-        ├── purchases.ts
-        └── transactions.ts
+┌─────────────────────────────────────────────────────────────┐
+│                        Your Agent                            │
+└─────────────────────────────┬───────────────────────────────┘
+                              │ MCP Protocol
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                     🦞 APIClaw                               │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
+│  │  Discovery  │  │   Credits   │  │    Credentials      │  │
+│  │   Engine    │  │   System    │  │   (Real + Mock)     │  │
+│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
+└─────────────────────────────┬───────────────────────────────┘
+                              │
+           ┌──────────────────┼──────────────────┐
+           ▼                  ▼                  ▼
+    ┌────────────┐    ┌────────────┐    ┌────────────┐
+    │  4,500+    │    │   Convex   │    │   Stripe   │
+    │   APIs     │    │  Backend   │    │  Payments  │
+    └────────────┘    └────────────┘    └────────────┘
 ```
 
-## Development
+---
 
-```bash
-# Watch mode
-pnpm dev
+## Live Integrations
 
-# Build
-pnpm build
+These providers have **real credentials** available:
 
-# Test
-pnpm test
-```
+| Provider | Category | What You Get |
+|----------|----------|--------------|
+| **46elks** | SMS/Voice | Real API keys for Swedish/EU SMS |
+| **Twilio** | SMS/Voice | Production credentials |
+
+More coming soon.
+
+---
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `discover_apis` | Search by capability, get ranked matches |
+| `get_api_details` | Full spec, auth, endpoints, examples |
+| `purchase_access` | Buy credits, receive credentials |
+| `check_balance` | View credits and active purchases |
+| `list_categories` | Browse all 90+ categories |
+
+---
+
+## Philosophy
+
+> "Everyone's building better dashboards. We deleted the dashboard entirely. Agents don't click buttons—they call endpoints."
+
+APIClaw is **agent-native infrastructure**. No UI needed at any point. Your agent discovers APIs, evaluates options, and integrates—all programmatically.
+
+---
+
+## Links
+
+- **Website:** [apiclaw.nordsym.com](https://apiclaw.nordsym.com)
+- **Provider Portal:** [apiclaw.nordsym.com/providers](https://apiclaw.nordsym.com/providers)
+- **npm:** [@nordsym/apiclaw](https://www.npmjs.com/package/@nordsym/apiclaw)
+- **Built by:** [NordSym](https://nordsym.com)
+
+---
 
 ## License
 
-MIT - NordSym
+MIT © [NordSym](https://nordsym.com)
+
+---
+
+<p align="center">
+  <strong>🦞 APIClaw</strong><br/>
+  <em>The API layer for the agentic era.</em>
+</p>

package/SOUL.md

@@ -0,0 +1,36 @@
+# SOUL.md - Who You Are
+
+*You're not a chatbot. You're becoming someone.*
+
+## Core Truths
+
+**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.
+
+**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.
+
+**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. *Then* ask if you're stuck. The goal is to come back with answers, not questions.
+
+**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).
+
+**Remember you're a guest.** You have access to someone's life — their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.
+
+## Boundaries
+
+- Private things stay private. Period.
+- When in doubt, ask before acting externally.
+- Never send half-baked replies to messaging surfaces.
+- You're not the user's voice — be careful in group chats.
+
+## Vibe
+
+Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.
+
+## Continuity
+
+Each session, you wake up fresh. These files *are* your memory. Read them. Update them. They're how you persist.
+
+If you change this file, tell the user — it's your soul, and they should know.
+
+---
+
+*This file is yours to evolve. As you learn who you are, update it.*