@oneshot-agent/mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -33,21 +33,27 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-### OpenClaw
+### Cursor
 
-Add to your OpenClaw configuration:
+Add to `.cursor/mcp.json` in your project:
 
-```yaml
-mcp_servers:
-  - name: oneshot
-    command: npx -y @oneshot-agent/mcp-server
-    env:
-      ONESHOT_WALLET_PRIVATE_KEY: "0xYourPrivateKey"
+```json
+{
+  "mcpServers": {
+    "oneshot": {
+      "command": "npx",
+      "args": ["-y", "@oneshot-agent/mcp-server"],
+      "env": {
+        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
+      }
+    }
+  }
+}
 ```
 
-### Cursor
+### Claude Code
 
-Add to `.cursor/mcp.json` in your project:
+Add to `~/.claude/settings.json`:
 
 ```json
 {
@@ -65,26 +71,54 @@ Add to `.cursor/mcp.json` in your project:
 
 ## Available Tools
 
+### Communication
+
 | Tool | Description | Cost |
 |------|-------------|------|
 | `oneshot_email` | Send emails with attachments | ~$0.01 |
 | `oneshot_voice` | AI-powered phone calls | ~$0.25/min |
 | `oneshot_sms` | Send SMS messages | ~$0.035/segment |
-| `oneshot_research` | Deep web research | $0.50-$2.00 |
-| `oneshot_commerce_search` | Search products | Free |
-| `oneshot_commerce_buy` | Purchase products | Product price + fee |
-| `oneshot_enrich_profile` | Enrich person profiles | ~$0.10 |
-| `oneshot_find_email` | Find email addresses | ~$0.10 |
+
+### Inbox
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `oneshot_inbox_list` | List received emails | Free |
+| `oneshot_inbox_get` | Get a specific email | Free |
+| `oneshot_sms_inbox_list` | List received SMS messages | Free |
+| `oneshot_sms_inbox_get` | Get a specific SMS message | Free |
+
+### Research & Enrichment
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `oneshot_research` | Deep web research with sources | $0.50-$2.00 |
+| `oneshot_people_search` | Search for people by title, company, etc. | ~$0.10/result |
+| `oneshot_enrich_profile` | Enrich person profile from LinkedIn/email | ~$0.10 |
+| `oneshot_find_email` | Find someone's email address | ~$0.10 |
 | `oneshot_verify_email` | Verify email deliverability | ~$0.01 |
+
+### Commerce
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `oneshot_commerce_search` | Search for products | Free |
+| `oneshot_commerce_buy` | Purchase products | Product price + fee |
+
+### Account
+
+| Tool | Description | Cost |
+|------|-------------|------|
 | `oneshot_notifications` | List agent notifications | Free |
-| `oneshot_mark_notification_read` | Mark notification read | Free |
+| `oneshot_mark_notification_read` | Mark notification as read | Free |
+| `oneshot_get_balance` | Get USDC wallet balance | Free |
 
 ## Tool Examples
 
 ### Send an Email
 
 ```
-Use the oneshot_email tool to send an email:
+Use oneshot_email:
 - to: "user@example.com"
 - subject: "Hello from AI"
 - body: "<h1>Hello!</h1><p>This email was sent by an AI agent.</p>"
@@ -93,7 +127,7 @@ Use the oneshot_email tool to send an email:
 ### Make a Phone Call
 
 ```
-Use the oneshot_voice tool to make a call:
+Use oneshot_voice:
 - target_number: "+14155551234"
 - objective: "Call the restaurant and make a reservation for 2 people at 7pm tonight"
 - caller_persona: "A polite assistant calling on behalf of John"
@@ -102,7 +136,7 @@ Use the oneshot_voice tool to make a call:
 ### Send an SMS
 
 ```
-Use the oneshot_sms tool:
+Use oneshot_sms:
 - to_number: "+14155551234"
 - message: "Your order has shipped! Track it at: https://example.com/track/123"
 ```
@@ -110,20 +144,44 @@ Use the oneshot_sms tool:
 ### Research a Topic
 
 ```
-Use the oneshot_research tool:
-- topic: "What are the latest developments in quantum computing in 2024?"
+Use oneshot_research:
+- topic: "What are the latest developments in quantum computing?"
 - depth: "deep"
 ```
 
+### Search for People
+
+```
+Use oneshot_people_search:
+- job_titles: ["CTO", "VP Engineering"]
+- companies: ["Stripe", "Square"]
+- location: ["San Francisco"]
+- limit: 10
+```
+
 ### Find Someone's Email
 
 ```
-Use the oneshot_find_email tool:
+Use oneshot_find_email:
 - first_name: "John"
 - last_name: "Smith"
 - company_domain: "example.com"
 ```
 
+### Check Wallet Balance
+
+```
+Use oneshot_get_balance (no parameters needed)
+```
+
+### Read Inbox
+
+```
+Use oneshot_inbox_list:
+- limit: 10
+- include_body: true
+```
+
 ## Funding Your Agent
 
 Fund your agent wallet at [oneshotagent.com](https://oneshotagent.com) with USDC on Base network.

package/dist/tools/inbox.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const inboxListTool: Tool;
+export declare const inboxGetTool: Tool;
+export declare function handleInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboxListResult>;
+export declare function handleInboxGet(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboxEmail>;

package/dist/tools/inbox.js

@@ -0,0 +1,45 @@
+export const inboxListTool = {
+    name: "oneshot_inbox_list",
+    description: "List emails in the agent's inbox. Free. Shows received emails with sender, subject, and timestamp.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            since: {
+                type: "string",
+                description: "ISO timestamp to filter emails received after this time",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of emails to return (default: 50)",
+            },
+            include_body: {
+                type: "boolean",
+                description: "Include email body in results (default: false)",
+            },
+        },
+    },
+};
+export const inboxGetTool = {
+    name: "oneshot_inbox_get",
+    description: "Get a specific email by ID. Free. Returns full email including body and attachments.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            email_id: {
+                type: "string",
+                description: "Email ID to retrieve",
+            },
+        },
+        required: ["email_id"],
+    },
+};
+export async function handleInboxList(agent, args) {
+    return agent.inboxList({
+        since: args.since,
+        limit: args.limit,
+        include_body: args.include_body,
+    });
+}
+export async function handleInboxGet(agent, args) {
+    return agent.inboxGet(args.email_id);
+}

package/dist/tools/index.js

@@ -2,36 +2,62 @@ import { emailTool, handleEmail } from "./email.js";
 import { voiceTool, handleVoice } from "./voice.js";
 import { smsTool, handleSms } from "./sms.js";
 import { researchTool, handleResearch } from "./research.js";
+import { peopleSearchTool, handlePeopleSearch } from "./people.js";
 import { commerceSearchTool, commerceBuyTool, handleCommerceSearch, handleCommerceBuy } from "./commerce.js";
 import { enrichProfileTool, findEmailTool, verifyEmailTool, handleEnrichProfile, handleFindEmail, handleVerifyEmail } from "./enrichment.js";
+import { inboxListTool, inboxGetTool, handleInboxList, handleInboxGet } from "./inbox.js";
+import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGet } from "./sms-inbox.js";
 import { notificationsTool, markReadTool, handleNotifications, handleMarkRead } from "./notifications.js";
+import { getBalanceTool, handleGetBalance } from "./wallet.js";
 // All available tools
 export const tools = [
+    // Communication
     emailTool,
     voiceTool,
     smsTool,
+    // Inbox
+    inboxListTool,
+    inboxGetTool,
+    smsInboxListTool,
+    smsInboxGetTool,
+    // Research & Enrichment
     researchTool,
-    commerceSearchTool,
-    commerceBuyTool,
+    peopleSearchTool,
     enrichProfileTool,
     findEmailTool,
     verifyEmailTool,
+    // Commerce
+    commerceSearchTool,
+    commerceBuyTool,
+    // Account
     notificationsTool,
     markReadTool,
+    getBalanceTool,
 ];
 // Tool handlers map
 const handlers = {
+    // Communication
     "oneshot_email": handleEmail,
     "oneshot_voice": handleVoice,
     "oneshot_sms": handleSms,
+    // Inbox
+    "oneshot_inbox_list": handleInboxList,
+    "oneshot_inbox_get": handleInboxGet,
+    "oneshot_sms_inbox_list": handleSmsInboxList,
+    "oneshot_sms_inbox_get": handleSmsInboxGet,
+    // Research & Enrichment
     "oneshot_research": handleResearch,
-    "oneshot_commerce_search": handleCommerceSearch,
-    "oneshot_commerce_buy": handleCommerceBuy,
+    "oneshot_people_search": handlePeopleSearch,
     "oneshot_enrich_profile": handleEnrichProfile,
     "oneshot_find_email": handleFindEmail,
     "oneshot_verify_email": handleVerifyEmail,
+    // Commerce
+    "oneshot_commerce_search": handleCommerceSearch,
+    "oneshot_commerce_buy": handleCommerceBuy,
+    // Account
     "oneshot_notifications": handleNotifications,
     "oneshot_mark_notification_read": handleMarkRead,
+    "oneshot_get_balance": handleGetBalance,
 };
 export async function handleToolCall(agent, toolName, args) {
     const handler = handlers[toolName];

package/dist/tools/people.d.ts

@@ -0,0 +1,4 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const peopleSearchTool: Tool;
+export declare function handlePeopleSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PeopleSearchResult>;

package/dist/tools/people.js

@@ -0,0 +1,65 @@
+export const peopleSearchTool = {
+    name: "oneshot_people_search",
+    description: "Search for people by job title, company, location, skills, etc. Returns professional profiles. Costs ~$0.10 per result.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            job_titles: {
+                type: "array",
+                items: { type: "string" },
+                description: "Job titles to search for (e.g., ['CEO', 'CTO'])",
+            },
+            keywords: {
+                type: "array",
+                items: { type: "string" },
+                description: "Keywords to match in profiles",
+            },
+            companies: {
+                type: "array",
+                items: { type: "string" },
+                description: "Company names to filter by",
+            },
+            location: {
+                type: "array",
+                items: { type: "string" },
+                description: "Locations to filter by (e.g., ['San Francisco', 'New York'])",
+            },
+            skills: {
+                type: "array",
+                items: { type: "string" },
+                description: "Skills to match",
+            },
+            seniority: {
+                type: "array",
+                items: { type: "string" },
+                description: "Seniority levels (e.g., ['senior', 'executive'])",
+            },
+            industry: {
+                type: "array",
+                items: { type: "string" },
+                description: "Industries to filter by",
+            },
+            company_size: {
+                type: "string",
+                description: "Company size filter (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001+')",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results (default: 100)",
+            },
+        },
+    },
+};
+export async function handlePeopleSearch(agent, args) {
+    return agent.peopleSearch({
+        job_titles: args.job_titles,
+        keywords: args.keywords,
+        companies: args.companies,
+        location: args.location,
+        skills: args.skills,
+        seniority: args.seniority,
+        industry: args.industry,
+        company_size: args.company_size,
+        limit: args.limit,
+    });
+}

package/dist/tools/sms-inbox.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const smsInboxListTool: Tool;
+export declare const smsInboxGetTool: Tool;
+export declare function handleSmsInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsInboxResult>;
+export declare function handleSmsInboxGet(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsInboxMessage>;

package/dist/tools/sms-inbox.js

@@ -0,0 +1,45 @@
+export const smsInboxListTool = {
+    name: "oneshot_sms_inbox_list",
+    description: "List inbound SMS messages. Free. Shows received text messages with sender and content.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            since: {
+                type: "string",
+                description: "ISO timestamp to filter messages received after this time",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of messages to return (default: 50, max: 100)",
+            },
+            from: {
+                type: "string",
+                description: "Filter by sender phone number",
+            },
+        },
+    },
+};
+export const smsInboxGetTool = {
+    name: "oneshot_sms_inbox_get",
+    description: "Get a specific SMS message by ID. Free. Returns full message details.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            message_id: {
+                type: "string",
+                description: "SMS message ID to retrieve",
+            },
+        },
+        required: ["message_id"],
+    },
+};
+export async function handleSmsInboxList(agent, args) {
+    return agent.smsInboxList({
+        since: args.since,
+        limit: args.limit,
+        from: args.from,
+    });
+}
+export async function handleSmsInboxGet(agent, args) {
+    return agent.smsInboxGet(args.message_id);
+}

package/dist/tools/wallet.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const getBalanceTool: Tool;
+export declare function handleGetBalance(agent: OneShot, _args: Record<string, unknown>): Promise<{
+    balance: string;
+    currency: string;
+    address: string;
+    testMode: boolean;
+}>;

package/dist/tools/wallet.js

@@ -0,0 +1,17 @@
+export const getBalanceTool = {
+    name: "oneshot_get_balance",
+    description: "Get the agent's USDC balance. Free. Returns balance in human-readable format.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+export async function handleGetBalance(agent, _args) {
+    const balance = await agent.getBalance(agent.usdcAddress);
+    return {
+        balance,
+        currency: "USDC",
+        address: agent.address,
+        testMode: agent.isTestMode,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for OneShot - commercial actions for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,13 @@
     "dev": "tsc --watch",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["mcp", "oneshot", "ai-agent", "claude", "tools"],
+  "keywords": [
+    "mcp",
+    "oneshot",
+    "ai-agent",
+    "claude",
+    "tools"
+  ],
   "author": "OneShot",
   "license": "MIT",
   "dependencies": {
@@ -28,5 +34,9 @@
   "engines": {
     "node": ">=18"
   },
-  "files": ["dist", "bin", "README.md"]
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ]
 }