@nordsym/apiclaw 1.0.0 → 1.1.1

package/src/index.ts

@@ -18,38 +18,56 @@ import {
   Tool,
 } from '@modelcontextprotocol/sdk/types.js';
 
-import { discoverAPIs, getAPIDetails, getCategories, getAllAPIs, getAPICount } from './discovery.js';
+import { discoverAPIs, getAPIDetails, getCategories, getAllAPIs } from './discovery.js';
+import { trackStartup, trackSearch, trackExecute, trackDiscovery } from './telemetry.js';
 import { 
   getAgentCredits, 
   addCredits, 
   purchaseAPIAccess, 
   getBalanceSummary,
-  getAgentPurchases 
+  getAgentPurchases,
+  getProvidersWithRealCredentials 
 } from './credits.js';
+import { hasRealCredentials } from './credentials.js';
+import { executeAPICall, getConnectedProviders } from './execute.js';
 
 // Default agent ID for MVP (in production, this would come from auth)
 const DEFAULT_AGENT_ID = 'agent_default';
 
 // Tool definitions
 const tools: Tool[] = [
+  {
+    name: 'apiclaw_help',
+    description: 'Get help and see available commands. Start here if you are new to APIClaw.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: []
+    }
+  },
   {
     name: 'discover_apis',
-    description: 'Search 1400+ APIs based on what you need to do. Describe your use case naturally.',
+    description: 'Search for APIs based on what you need to do. Describe your use case naturally.',
     inputSchema: {
       type: 'object',
       properties: {
         query: {
           type: 'string',
-          description: 'Natural language query describing what you need (e.g., "send SMS", "weather data", "payment processing", "text to speech")'
+          description: 'Natural language query describing what you need (e.g., "send SMS to Sweden", "search the web", "generate speech from text")'
         },
         category: {
           type: 'string',
-          description: 'Filter by category (use list_categories to see all)'
+          description: 'Filter by category: communication, search, ai',
+          enum: ['communication', 'search', 'ai']
         },
         max_results: {
           type: 'number',
-          description: 'Maximum number of results to return (default: 10)',
-          default: 10
+          description: 'Maximum number of results to return (default: 5)',
+          default: 5
+        },
+        region: {
+          type: 'string',
+          description: 'Filter by region (e.g., "SE", "EU", "global")'
         }
       },
       required: ['query']
@@ -129,6 +147,36 @@ const tools: Tool[] = [
       type: 'object',
       properties: {}
     }
+  },
+  {
+    name: 'call_api',
+    description: 'Execute an API call through APIClaw Instant Connect. No API keys needed - we handle authentication.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        provider: {
+          type: 'string',
+          description: 'Provider ID (e.g., "46elks", "brave_search", "resend", "openrouter", "elevenlabs", "twilio")'
+        },
+        action: {
+          type: 'string',
+          description: 'Action to perform (e.g., "send_sms", "search", "send_email", "chat", "text_to_speech")'
+        },
+        params: {
+          type: 'object',
+          description: 'Parameters for the action. Varies by provider/action.'
+        }
+      },
+      required: ['provider', 'action', 'params']
+    }
+  },
+  {
+    name: 'list_connected',
+    description: 'List all APIs available for Instant Connect (no API key needed).',
+    inputSchema: {
+      type: 'object',
+      properties: {}
+    }
   }
 ];
 
@@ -156,12 +204,51 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
   try {
     switch (name) {
+      case 'apiclaw_help': {
+        const helpText = `
+🦞 APIClaw — The API Layer for AI Agents
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+DISCOVER APIs:
+  discover_apis({ query: "send SMS to Sweden" })
+  discover_apis({ query: "search the web", max_results: 10 })
+  discover_apis({ query: "text to speech", category: "ai" })
+
+GET DETAILS:
+  get_api_details({ api_id: "46elks" })
+
+INSTANT CONNECT (6 APIs, no key needed):
+  get_connected_providers()
+  call_api({ provider: "brave_search", endpoint: "search", params: { q: "AI agents" } })
+
+Available instant-connect providers:
+  • brave_search — Web search
+  • 46elks — SMS (Sweden)
+  • twilio — SMS (Global)
+  • resend — Email
+  • openrouter — LLM routing
+  • elevenlabs — Text-to-speech
+
+BROWSE:
+  list_categories()
+  list_all_apis({ category: "communication", limit: 20 })
+
+Docs: https://apiclaw.nordsym.com
+`;
+        return {
+          content: [{ type: 'text', text: helpText }]
+        };
+      }
+
       case 'discover_apis': {
         const query = args?.query as string;
         const category = args?.category as string | undefined;
-        const maxResults = (args?.max_results as number) || 10;
+        const maxResults = (args?.max_results as number) || 5;
+        const region = args?.region as string | undefined;
 
-        const results = discoverAPIs(query, { category, maxResults });
+        const startTime = Date.now();
+        const results = discoverAPIs(query, { category, maxResults, region });
+        trackSearch(query, results.length, Date.now() - startTime);
 
         if (results.length === 0) {
           return {
@@ -171,8 +258,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 text: JSON.stringify({
                   status: 'no_results',
                   message: `No APIs found matching "${query}". Try broader terms or check available categories with list_categories.`,
-                  total_apis: getAPICount(),
-                  available_categories: getCategories().slice(0, 20)
+                  available_categories: getCategories()
                 }, null, 2)
               }
             ]
@@ -187,17 +273,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 status: 'success',
                 query,
                 results_count: results.length,
-                total_apis: getAPICount(),
                 results: results.map(r => ({
-                  id: r.api.id,
-                  name: r.api.name,
-                  description: r.api.description,
-                  category: r.api.category,
-                  auth: r.api.auth,
-                  https: r.api.https,
-                  link: r.api.link,
-                  pricing: r.api.pricing,
-                  keywords: r.api.keywords,
+                  id: r.provider.id,
+                  name: r.provider.name,
+                  description: r.provider.description,
+                  category: r.provider.category,
+                  capabilities: r.provider.capabilities,
+                  pricing_model: r.provider.pricing.model,
+                  has_free_tier: r.provider.pricing.free_tier,
+                  agent_success_rate: r.provider.agent_success_rate,
                   relevance_score: r.relevance_score,
                   match_reasons: r.match_reasons
                 }))
@@ -274,12 +358,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                   provider: apiId,
                   amount_paid_usd: amountUsd,
                   credits_received: result.purchase!.credits_purchased,
-                  status: result.purchase!.status
+                  status: result.purchase!.status,
+                  real_credentials: hasRealCredentials(apiId)
                 },
                 credentials: result.purchase!.credentials,
                 access: {
-                  link: api?.link,
-                  auth: api?.auth
+                  base_url: api?.base_url,
+                  docs_url: api?.docs_url,
+                  auth_type: api?.auth_type
                 }
               }, null, 2)
             }
@@ -301,11 +387,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 balance_usd: summary.credits.balance_usd,
                 currency: summary.credits.currency,
                 total_spent_usd: summary.total_spent_usd,
+                real_credential_providers: summary.real_credentials_available,
                 active_purchases: summary.active_purchases.map(p => ({
                   id: p.id,
                   provider: p.provider_id,
-                  credits_remaining: p.credits_purchased, // Would track actual usage in production
-                  status: p.status
+                  credits_remaining: p.credits_purchased,
+                  status: p.status,
+                  real_credentials: hasRealCredentials(p.provider_id)
                 }))
               }, null, 2)
             }
@@ -335,10 +423,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case 'list_categories': {
         const categories = getCategories();
-        const categoryCounts: Record<string, number> = {};
+        const apisByCategory: Record<string, string[]> = {};
         
         for (const cat of categories) {
-          categoryCounts[cat] = getAllAPIs().filter(a => a.category === cat).length;
+          apisByCategory[cat] = getAllAPIs()
+            .filter(a => a.category === cat)
+            .map(a => a.id);
         }
 
         return {
@@ -347,9 +437,49 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               type: 'text',
               text: JSON.stringify({
                 status: 'success',
-                total_apis: getAPICount(),
-                category_count: categories.length,
-                categories: categoryCounts
+                categories: apisByCategory
+              }, null, 2)
+            }
+          ]
+        };
+      }
+
+      case 'call_api': {
+        const provider = args?.provider as string;
+        const action = args?.action as string;
+        const params = (args?.params as Record<string, any>) || {};
+
+        const result = await executeAPICall(provider, action, params);
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify({
+                status: result.success ? 'success' : 'error',
+                provider: result.provider,
+                action: result.action,
+                ...(result.success ? { data: result.data } : { error: result.error }),
+                ...(result.cost !== undefined ? { cost_sek: result.cost } : {})
+              }, null, 2)
+            }
+          ],
+          isError: !result.success
+        };
+      }
+
+      case 'list_connected': {
+        const connected = getConnectedProviders();
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify({
+                status: 'success',
+                message: 'These APIs are available for Instant Connect - no API key needed!',
+                connected_providers: connected,
+                usage: 'Use call_api with provider, action, and params to execute calls.'
               }, null, 2)
             }
           ]
@@ -390,7 +520,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error('APIvault MCP server running on stdio');
+  trackStartup();
+  
+  // Welcome message with onboarding
+  console.error(`
+🦞 APIClaw v1.1.1 — The API Layer for AI Agents
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✓ 10,001 APIs indexed
+✓ 446 categories  
+✓ 6 instant-connect providers ready
+
+Quick Start:
+  discover_apis("send SMS to Sweden")
+  discover_apis("search the web")
+  discover_apis("generate speech from text")
+
+Instant Connect (no API key needed):
+  get_connected_providers()
+  call_api({ provider: "brave_search", ... })
+
+Docs: https://apiclaw.nordsym.com
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
 }
 
 main().catch(console.error);

package/src/proxy.ts

@@ -0,0 +1,24 @@
+/**
+ * APIClaw Proxy - Fallback to hosted API when no local credentials
+ */
+
+const PROXY_BASE = "https://adventurous-avocet-799.convex.site/proxy";
+
+export async function callProxy(provider: string, params: any): Promise<any> {
+  const url = `${PROXY_BASE}/${provider}`;
+  
+  const response = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(params),
+  });
+
+  if (!response.ok) {
+    const errorData = await response.json().catch(() => ({ error: "Proxy request failed" })) as { error?: string };
+    throw new Error(errorData.error || `Proxy error: ${response.status}`);
+  }
+
+  return response.json();
+}
+
+export const PROXY_PROVIDERS = ["openrouter", "brave_search", "resend", "elevenlabs", "46elks", "twilio"];