atxp-call 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:docs.atxp.ai)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DNR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# atxp-call
+
+A command-line tool for calling tools on ATXP MCP servers.
+
+## Installation
+
+```bash
+npm install
+```
+
+## Configuration
+
+Before using `atxp-call`, you need to set up your ATXP connection string:
+
+```bash
+export ATXP_CONNECTION="your-connection-string"
+```
+
+Or create a `.env` file in the project directory:
+
+```
+ATXP_CONNECTION=your-connection-string
+```
+
+You can find your connection string at https://accounts.atxp.ai
+
+## Usage
+
+```bash
+./atxp-call.js <server> <tool> <arguments_json> [--x402] [--no-parse] [--verbose]
+```
+
+Or if installed globally:
+
+```bash
+atxp-call <server> <tool> <arguments_json> [--x402] [--no-parse] [--verbose]
+```
+
+### Required Arguments
+
+- `server` - The server URL or identifier (https:// is prepended automatically if not present)
+- `tool` - The tool name to invoke
+- `arguments_json` - JSON string containing tool arguments
+
+### Optional Flags
+
+- `--x402` - Enable x402 mode
+- `--no-parse` - Return full result object instead of parsed text
+- `--verbose` - Show verbose output from dependencies
+
+## Examples
+
+### ATXP MCP Servers
+
+Search X (formerly Twitter) for posts:
+
+```bash
+./atxp-call.js x-live-search.mcp.atxp.ai x_live_search '{"query": "What are the latest updates from Space X?"}'
+```
+
+Perform web search:
+
+```bash
+./atxp-call.js search.mcp.atxp.ai search '{"query": "latest AI developments"}'
+```
+
+Crawl a webpage:
+
+```bash
+./atxp-call.js crawl.mcp.atxp.ai crawl '{"url": "https://example.com"}'
+```
+
+Generate an image:
+
+```bash
+./atxp-call.js image.mcp.atxp.ai generate_image '{"prompt": "A sunset over mountains", "sync": true}'
+```
+
+Execute code in a sandbox:
+
+```bash
+./atxp-call.js code.mcp.atxp.ai execute_code '{"language": "python", "code": "print(\"Hello, World!\")"}'
+```
+
+Research a topic:
+
+```bash
+./atxp-call.js research.mcp.atxp.ai research '{"query": "quantum computing applications", "depth": "quick"}'
+```
+
+See available MCP servers at: https://docs.atxp.ai/client/mcp_servers
+
+## Dependencies
+
+- [@atxp/client](https://www.npmjs.com/package/@atxp/client) - ATXP client library
+- [@atxp/x402](https://www.npmjs.com/package/@atxp/x402) - X402 protocol support
+
+## License
+
+MIT

package/atxp-call.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+
+// Check for --verbose flag before loading any dependencies
+const isVerbose = process.argv.includes('--verbose');
+
+// Save original console and suppress output from dependencies unless --verbose is set
+const originalConsole = {
+  log: console.log,
+  error: console.error,
+  warn: console.warn,
+  info: console.info,
+  debug: console.debug,
+};
+
+if (!isVerbose) {
+  const noop = () => {};
+  console.log = noop;
+  console.error = noop;
+  console.warn = noop;
+  console.info = noop;
+  console.debug = noop;
+}
+
+// Load environment variables from .env file if present
+require('dotenv').config();
+
+const { atxpClient, ATXPAccount } = require('@atxp/client');
+const { wrapWithX402 } = require('@atxp/x402');
+
+function printUsage() {
+  originalConsole.error('Usage: atxp-call <server> <tool> <arguments_json> [--x402] [--no-parse] [--verbose]');
+  originalConsole.error('');
+  originalConsole.error('Required arguments:');
+  originalConsole.error('  server         - The server URL or identifier');
+  originalConsole.error('  tool           - The tool name to invoke');
+  originalConsole.error('  arguments_json - JSON string containing tool arguments');
+  originalConsole.error('');
+  originalConsole.error('Optional flags:');
+  originalConsole.error('  --x402         - Enable x402 mode');
+  originalConsole.error('  --no-parse     - Return full result object instead of parsed text');
+  originalConsole.error('  --verbose      - Show verbose output from dependencies');
+  process.exit(1);
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 3) {
+    originalConsole.error('Error: Missing required arguments\n');
+    printUsage();
+  }
+
+  // Check for --x402 flag
+  const x402Index = args.indexOf('--x402');
+  const hasX402 = x402Index !== -1;
+
+  // Remove flag from args if present
+  if (hasX402) {
+    args.splice(x402Index, 1);
+  }
+
+  // Check for --no-parse flag
+  const noParseIndex = args.indexOf('--no-parse');
+  const hasNoParse = noParseIndex !== -1;
+
+  // Remove flag from args if present
+  if (hasNoParse) {
+    args.splice(noParseIndex, 1);
+  }
+
+  // Check for --verbose flag
+  const verboseIndex = args.indexOf('--verbose');
+  const hasVerbose = verboseIndex !== -1;
+
+  // Remove flag from args if present
+  if (hasVerbose) {
+    args.splice(verboseIndex, 1);
+  }
+
+  if (args.length !== 3) {
+    originalConsole.error('Error: Expected exactly 3 positional arguments\n');
+    printUsage();
+  }
+
+  let [server, tool, argumentsJson] = args;
+
+  // Prepend https:// if not already present
+  if (!server.startsWith('http://') && !server.startsWith('https://')) {
+    server = `https://${server}`;
+  }
+
+  // Validate arguments_json is valid JSON
+  let parsedArguments;
+  try {
+    parsedArguments = JSON.parse(argumentsJson);
+  } catch (error) {
+    originalConsole.error(`Error: arguments_json must be valid JSON: ${error.message}\n`);
+    printUsage();
+  }
+
+  return {
+    server,
+    tool,
+    argumentsJson,
+    parsedArguments,
+    x402: hasX402,
+    noParse: hasNoParse,
+    verbose: hasVerbose
+  };
+}
+
+async function main() {
+  const config = parseArgs();
+
+  // Validate ATXP_CONNECTION environment variable
+  const atxpConnectionString = process.env.ATXP_CONNECTION;
+  if (!atxpConnectionString) {
+    originalConsole.error('Error: ATXP_CONNECTION environment variable is not set\n');
+    originalConsole.error('Please set the ATXP_CONNECTION environment variable:');
+    originalConsole.error('  export ATXP_CONNECTION="your-connection-string"');
+    originalConsole.error('');
+    originalConsole.error('Or create a .env file in the current directory with:');
+    originalConsole.error('  ATXP_CONNECTION=your-connection-string');
+    originalConsole.error('');
+    originalConsole.error('You can find your connection string at https://accounts.atxp.ai');
+    originalConsole.error('');
+    process.exit(1);
+  }
+
+  const atxpConfig = {
+    mcpServer: config.server,
+    account: new ATXPAccount(atxpConnectionString),
+  };
+
+  // Create a client using the `atxpClient` function
+  const client = await atxpClient({
+    ...atxpConfig,
+    fetchFn: config.x402 ? wrapWithX402(atxpConfig) : undefined,
+  });
+  const result = await client.callTool({
+    name: config.tool,
+    arguments: config.parsedArguments,
+  });
+
+  // Output to stdout in CLI-idiomatic way
+  if (config.noParse) {
+    originalConsole.log(JSON.stringify(result, null, 2));
+  } else {
+    const text = result.content[0].text;
+
+    // Try to parse and pretty-print if it's JSON
+    try {
+      const parsed = JSON.parse(text);
+      originalConsole.log(JSON.stringify(parsed, null, 2));
+    } catch {
+      // Not JSON or invalid JSON, print as-is
+      originalConsole.log(text);
+    }
+  }
+}
+
+// Run if executed directly
+if (require.main === module) {
+  main().catch(error => {
+    originalConsole.error('Error:', error.message);
+    process.exit(1);
+  });
+}
+
+module.exports = { parseArgs, main };

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "atxp-call",
+  "version": "1.0.0",
+  "description": "A command-line tool for calling tools on ATXP MCP servers",
+  "license": "MIT",
+  "author": "DNR",
+  "type": "commonjs",
+  "main": "atxp-call.js",
+  "bin": {
+    "atxp-call": "./atxp-call.js"
+  },
+  "keywords": [
+    "atxp",
+    "mcp",
+    "cli",
+    "tool"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@atxp/client": "^0.7.4",
+    "@atxp/x402": "^0.7.4",
+    "dotenv": "^16.4.5"
+  }
+}