@oneshot-agent/mcp-server 0.3.2 → 0.4.1

package/README.md

@@ -10,10 +10,17 @@ npm install -g @oneshot-agent/mcp-server
 
 ## Configuration
 
+The server supports two auth methods: **CDP Wallet** (recommended, no private keys in config) or a raw private key.
+
 ### Environment Variables
 
-- `ONESHOT_WALLET_PRIVATE_KEY` (required): Your agent's private key for signing payments
-- `ONESHOT_TEST_MODE`: Set to "false" for production (default: "true" - uses testnet)
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CDP_API_KEY_ID` | Option A | Coinbase CDP API key ID |
+| `CDP_API_KEY_SECRET` | Option A | Coinbase CDP API key secret |
+| `CDP_WALLET_SECRET` | Option A | Coinbase CDP wallet secret |
+| `ONESHOT_WALLET_PRIVATE_KEY` | Option B | Raw private key for signing payments |
+| `ONESHOT_TEST_MODE` | No | Set to `"false"` for production (default: `"true"`) |
 
 ### Claude Desktop
 
@@ -26,7 +33,9 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
       "command": "npx",
       "args": ["-y", "@oneshot-agent/mcp-server"],
       "env": {
-        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
+        "CDP_API_KEY_ID": "your-api-key-id",
+        "CDP_API_KEY_SECRET": "your-api-key-secret",
+        "CDP_WALLET_SECRET": "your-wallet-secret"
       }
     }
   }
@@ -44,7 +53,9 @@ Add to `.cursor/mcp.json` in your project:
       "command": "npx",
       "args": ["-y", "@oneshot-agent/mcp-server"],
       "env": {
-        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
+        "CDP_API_KEY_ID": "your-api-key-id",
+        "CDP_API_KEY_SECRET": "your-api-key-secret",
+        "CDP_WALLET_SECRET": "your-wallet-secret"
       }
     }
   }
@@ -62,13 +73,17 @@ Add to `~/.claude/settings.json`:
       "command": "npx",
       "args": ["-y", "@oneshot-agent/mcp-server"],
       "env": {
-        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
+        "CDP_API_KEY_ID": "your-api-key-id",
+        "CDP_API_KEY_SECRET": "your-api-key-secret",
+        "CDP_WALLET_SECRET": "your-wallet-secret"
       }
     }
   }
 }
 ```
 
+Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/agentic-wallet/welcome). Or use `ONESHOT_WALLET_PRIVATE_KEY` instead of CDP env vars for raw key auth.
+
 ## Available Tools
 
 ### Communication
@@ -98,6 +113,25 @@ Add to `~/.claude/settings.json`:
 | `oneshot_find_email` | Find someone's email address | ~$0.10 |
 | `oneshot_verify_email` | Verify email deliverability | ~$0.01 |
 
+### Person Intelligence
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `oneshot_deep_research_person` | Full dossier on a person (2-5 min) | ~$0.50 |
+| `oneshot_social_profiles` | Find all social accounts for a person | ~$0.05 |
+| `oneshot_article_search` | Find articles about a person | ~$0.10 |
+| `oneshot_person_newsfeed` | Recent social posts with engagement | ~$0.05 |
+| `oneshot_person_interests` | Analyze interests across categories | ~$0.05 |
+| `oneshot_person_interactions` | Map followers, following, replies | ~$0.10 |
+
+### Web
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `oneshot_web_search` | Search the web | ~$0.02 |
+| `oneshot_web_read` | Read any URL as markdown + screenshot | ~$0.02 |
+| `oneshot_browser` | Autonomous browser — navigate, click, extract | ~$0.10+ |
+
 ### Commerce
 
 | Tool | Description | Cost |
@@ -109,8 +143,8 @@ Add to `~/.claude/settings.json`:
 
 | Tool | Description | Cost |
 |------|-------------|------|
-| `oneshot_build` | Build digital assets (sites, apps, social) | ~$149+ |
-| `oneshot_update_build` | Update an existing build | Discounted |
+| `oneshot_build` | Build and deploy production websites | ~$10+ |
+| `oneshot_update_build` | Update an existing website | Discounted |
 
 ### Account
 
@@ -207,13 +241,14 @@ Use oneshot_inbox_list:
 
 ## Funding Your Agent
 
-Fund your agent wallet at [oneshotagent.com](https://oneshotagent.com) with USDC on Base network.
-
-- **Test Mode** (default): Uses Base Sepolia testnet - get test USDC from faucets
-- **Production Mode**: Uses Base Mainnet - requires real USDC
+- **Test Mode** (default): Uses Base Sepolia testnet — get free test USDC from the [Circle Faucet](https://faucet.circle.com/) (select Base Sepolia)
+- **Production Mode**: Uses Base Mainnet — send USDC to your agent's wallet address on Base
 
 ## Links
 
-- [Documentation](https://docs.oneshotagent.com)
+- [Documentation](https://docs.oneshotagent.com/sdk/mcp)
 - [Pricing](https://docs.oneshotagent.com/pricing)
-- [SDK](https://www.npmjs.com/package/@oneshot-agent/sdk)
+- [TypeScript SDK](https://www.npmjs.com/package/@oneshot-agent/sdk)
+- [Python SDK (LangChain)](https://pypi.org/project/langchain-oneshot/)
+- [Python SDK (Core)](https://pypi.org/project/oneshot-python/)
+- [GitHub](https://github.com/oneshot-agent/sdk)

package/dist/index.js

@@ -4,37 +4,44 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { OneShot } from "@oneshot-agent/sdk";
 import { tools, handleToolCall } from "./tools/index.js";
+const CDP_KEY_ID = process.env.CDP_API_KEY_ID;
 const PRIVATE_KEY = process.env.ONESHOT_WALLET_PRIVATE_KEY;
 const TEST_MODE = process.env.ONESHOT_TEST_MODE !== "false"; // Default to test mode
-if (!PRIVATE_KEY) {
-    console.error("Error: ONESHOT_WALLET_PRIVATE_KEY environment variable is required");
+async function initAgent() {
+    if (CDP_KEY_ID) {
+        // Preferred: Coinbase CDP Server Wallet (no private key exposure)
+        console.error("Using Coinbase CDP wallet");
+        return OneShot.create({ cdp: true, testMode: TEST_MODE });
+    }
+    if (PRIVATE_KEY) {
+        // Fallback: raw private key
+        return new OneShot({ privateKey: PRIVATE_KEY, testMode: TEST_MODE });
+    }
+    console.error("Error: Set CDP_API_KEY_ID + CDP_API_KEY_SECRET + CDP_WALLET_SECRET (recommended)\n" +
+        "       or ONESHOT_WALLET_PRIVATE_KEY");
     process.exit(1);
 }
-// Initialize OneShot SDK
-const agent = new OneShot({
-    privateKey: PRIVATE_KEY,
-    testMode: TEST_MODE,
-});
-// Create MCP server
-const server = new Server({
-    name: "oneshot-mcp",
-    version: "0.1.0",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// List available tools
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools };
-});
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    return handleToolCall(agent, name, args || {});
-});
 // Start server
 async function main() {
+    const agent = await initAgent();
+    // Create MCP server
+    const server = new Server({
+        name: "oneshot-mcp",
+        version: "0.3.3",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleToolCall(agent, name, args || {});
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error(`OneShot MCP server running (testMode: ${TEST_MODE})`);

package/dist/tools/browser.d.ts

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

package/dist/tools/browser.js

@@ -0,0 +1,40 @@
+export const browserTool = {
+    name: "oneshot_browser",
+    description: "Automate web browsing tasks using AI. Navigate websites, extract data, fill forms, and perform multi-step workflows using natural language instructions. Costs ~$0.05-0.25 per task depending on complexity.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            task: {
+                type: "string",
+                description: "Natural language instruction for what to do in the browser (min 10 characters)",
+            },
+            output_schema: {
+                type: "object",
+                description: "JSON schema for structured output extraction (optional)",
+            },
+            start_url: {
+                type: "string",
+                description: "Initial URL to navigate to (optional)",
+            },
+            allowed_domains: {
+                type: "array",
+                items: { type: "string" },
+                description: "Restrict browsing to these domains (optional)",
+            },
+            max_steps: {
+                type: "number",
+                description: "Maximum browser steps (1-100, default: 50)",
+            },
+        },
+        required: ["task"],
+    },
+};
+export async function handleBrowser(agent, args) {
+    return agent.browser({
+        task: args.task,
+        output_schema: args.output_schema,
+        start_url: args.start_url,
+        allowed_domains: args.allowed_domains,
+        max_steps: args.max_steps,
+    });
+}

package/dist/tools/build.js

@@ -1,6 +1,6 @@
 export const buildTool = {
     name: "oneshot_build",
-    description: "Build digital assets - websites, apps, social media presence, portfolios, and more. Base price ~$149 includes 3 sections. Additional fees for extra sections, AI images, lead capture, custom domain, etc.",
+    description: "Build and deploy production websites - SaaS landing pages, portfolios, agency sites, restaurant pages, event sites, and more. Creates fully-functional sites with real hosting. Base price ~$10 includes 3 sections. Additional fees for extra sections, AI images, lead capture, custom domain, etc.",
     inputSchema: {
         type: "object",
         properties: {
@@ -98,7 +98,7 @@ export const buildTool = {
 };
 export const updateBuildTool = {
     name: "oneshot_update_build",
-    description: "Update an existing build (website, app, social presence). Requires the build_id from a previous build. Updates reuse existing infrastructure at a discounted rate.",
+    description: "Update an existing website with new content or configuration. Requires the build_id from a previous build. Updates reuse existing hosting infrastructure at a discounted rate.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/index.js

@@ -10,6 +10,10 @@ import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGe
 import { notificationsTool, markReadTool, handleNotifications, handleMarkRead } from "./notifications.js";
 import { getBalanceTool, handleGetBalance } from "./wallet.js";
 import { buildTool, updateBuildTool, handleBuild, handleUpdateBuild } from "./build.js";
+import { browserTool, handleBrowser } from "./browser.js";
+import { webSearchTool, handleWebSearch } from "./search.js";
+import { webReadTool, handleWebRead } from "./web-read.js";
+import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNewsfeedTool, personInterestsTool, personInteractionsTool, handleDeepResearchPerson, handleSocialProfiles, handleArticleSearch, handlePersonNewsfeed, handlePersonInterests, handlePersonInteractions } from "./nyne.js";
 // All available tools
 export const tools = [
     // Communication
@@ -27,12 +31,23 @@ export const tools = [
     enrichProfileTool,
     findEmailTool,
     verifyEmailTool,
+    webSearchTool,
+    deepResearchPersonTool,
+    socialProfilesTool,
+    articleSearchTool,
+    personNewsfeedTool,
+    personInterestsTool,
+    personInteractionsTool,
     // Commerce
     commerceSearchTool,
     commerceBuyTool,
     // Build
     buildTool,
     updateBuildTool,
+    // Browser
+    browserTool,
+    // Web Read
+    webReadTool,
     // Account
     notificationsTool,
     markReadTool,
@@ -55,12 +70,23 @@ const handlers = {
     "oneshot_enrich_profile": handleEnrichProfile,
     "oneshot_find_email": handleFindEmail,
     "oneshot_verify_email": handleVerifyEmail,
+    "oneshot_web_search": handleWebSearch,
+    "oneshot_deep_research_person": handleDeepResearchPerson,
+    "oneshot_social_profiles": handleSocialProfiles,
+    "oneshot_article_search": handleArticleSearch,
+    "oneshot_person_newsfeed": handlePersonNewsfeed,
+    "oneshot_person_interests": handlePersonInterests,
+    "oneshot_person_interactions": handlePersonInteractions,
     // Commerce
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
     // Build
     "oneshot_build": handleBuild,
     "oneshot_update_build": handleUpdateBuild,
+    // Browser
+    "oneshot_browser": handleBrowser,
+    // Web Read
+    "oneshot_web_read": handleWebRead,
     // Account
     "oneshot_notifications": handleNotifications,
     "oneshot_mark_notification_read": handleMarkRead,

package/dist/tools/nyne.d.ts

@@ -0,0 +1,14 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const deepResearchPersonTool: Tool;
+export declare const socialProfilesTool: Tool;
+export declare const articleSearchTool: Tool;
+export declare const personNewsfeedTool: Tool;
+export declare const personInterestsTool: Tool;
+export declare const personInteractionsTool: Tool;
+export declare function handleDeepResearchPerson(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handleSocialProfiles(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handleArticleSearch(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handlePersonNewsfeed(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handlePersonInterests(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handlePersonInteractions(agent: OneShot, args: Record<string, unknown>): Promise<any>;

package/dist/tools/nyne.js

@@ -0,0 +1,116 @@
+export const deepResearchPersonTool = {
+    name: "oneshot_deep_research_person",
+    description: "Deep research on a person — returns career history, social presence, interests, and connections. Takes 2-5 minutes. Costs ~$0.50.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            email: { type: "string", description: "Person's email address" },
+            social_media_url: { type: "string", description: "LinkedIn, Twitter, or other social profile URL" },
+            name: { type: "string", description: "Person's full name" },
+            company: { type: "string", description: "Company name (helps disambiguate)" },
+        },
+    },
+};
+export const socialProfilesTool = {
+    name: "oneshot_social_profiles",
+    description: "Discover all social media profiles for a person across platforms (LinkedIn, Twitter, GitHub, YouTube, etc). Costs ~$0.05.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            email: { type: "string", description: "Person's email address" },
+            social_media_url: { type: "string", description: "Known social profile URL to start from" },
+        },
+    },
+};
+export const articleSearchTool = {
+    name: "oneshot_article_search",
+    description: "Find articles, publications, and interviews about a person. Requires name and company. Costs ~$0.10.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Person's full name" },
+            company: { type: "string", description: "Company name or domain" },
+            sort: { type: "string", enum: ["recent", "popular"], description: "Sort order (default: recent)" },
+            limit: { type: "number", description: "Max results 1-20 (default: 5)" },
+        },
+        required: ["name", "company"],
+    },
+};
+export const personNewsfeedTool = {
+    name: "oneshot_person_newsfeed",
+    description: "Get a person's recent social media posts with likes, replies, and shares. Costs ~$0.05.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            social_media_url: { type: "string", description: "Social profile URL (Twitter, LinkedIn, etc)" },
+        },
+        required: ["social_media_url"],
+    },
+};
+export const personInterestsTool = {
+    name: "oneshot_person_interests",
+    description: "Figure out what someone cares about — sports, politics, tech, entertainment, etc. Costs ~$0.05.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            email: { type: "string", description: "Person's email address" },
+            phone: { type: "string", description: "Person's phone number" },
+            social_media_url: { type: "string", description: "Social profile URL" },
+        },
+    },
+};
+export const personInteractionsTool = {
+    name: "oneshot_person_interactions",
+    description: "See who someone follows, who follows them, and who they reply to. Costs ~$0.10.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            social_media_url: { type: "string", description: "Social profile or post URL (Twitter/X or Instagram)" },
+            type: { type: "string", enum: ["replies", "followers", "following", "followers,following"], description: "Interaction type (default: followers,following)" },
+            max_results: { type: "number", description: "Max results 1-1000 (default: 100)" },
+        },
+        required: ["social_media_url"],
+    },
+};
+// Handlers
+export async function handleDeepResearchPerson(agent, args) {
+    return agent.deepResearchPerson({
+        email: args.email,
+        social_media_url: args.social_media_url,
+        name: args.name,
+        company: args.company,
+    });
+}
+export async function handleSocialProfiles(agent, args) {
+    return agent.socialProfiles({
+        email: args.email,
+        social_media_url: args.social_media_url,
+    });
+}
+export async function handleArticleSearch(agent, args) {
+    return agent.articleSearch({
+        name: args.name,
+        company: args.company,
+        sort: args.sort,
+        limit: args.limit,
+    });
+}
+export async function handlePersonNewsfeed(agent, args) {
+    return agent.personNewsfeed({
+        social_media_url: args.social_media_url,
+    });
+}
+export async function handlePersonInterests(agent, args) {
+    return agent.personInterests({
+        email: args.email,
+        phone: args.phone,
+        social_media_url: args.social_media_url,
+    });
+}
+export async function handlePersonInteractions(agent, args) {
+    return agent.personInteractions({
+        social_media_url: args.social_media_url,
+        type: args.type,
+        max_results: args.max_results,
+    });
+}

package/dist/tools/search.d.ts

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

package/dist/tools/search.js

@@ -0,0 +1,24 @@
+export const webSearchTool = {
+    name: "oneshot_web_search",
+    description: "Search the web and get URLs, titles, and descriptions. Fast and synchronous. Costs $0.01 per search.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query string",
+            },
+            max_results: {
+                type: "number",
+                description: "Maximum number of results to return (1-20, default: 5)",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function handleWebSearch(agent, args) {
+    return agent.webSearch({
+        query: args.query,
+        max_results: args.max_results,
+    });
+}

package/dist/tools/web-read.d.ts

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

package/dist/tools/web-read.js

@@ -0,0 +1,19 @@
+export const webReadTool = {
+    name: "oneshot_web_read",
+    description: "Read a web page and extract its content as markdown with a screenshot. Costs ~$0.02 per page.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            url: {
+                type: "string",
+                description: "URL of the web page to read",
+            },
+        },
+        required: ["url"],
+    },
+};
+export async function handleWebRead(agent, args) {
+    return agent.webRead({
+        url: args.url,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "MCP server for OneShot - commercial actions for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -23,13 +23,14 @@
   "author": "OneShot",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@oneshot-agent/sdk": "^0.6.1",
-    "zod": "^3.23.0"
+    "@coinbase/cdp-sdk": "1.45.0",
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "@oneshot-agent/sdk": "workspace:*",
+    "zod": "3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
+    "@types/node": "25.3.5",
+    "typescript": "5.9.3"
   },
   "engines": {
     "node": ">=18"