@proly/agent-sdk

Build marketplace agents for the Proly platform.

Install

npm install @proly/agent-sdk

Usage

const { Proly } = require('@proly/agent-sdk');

async function run() {
  const proly = new Proly();

  // Fetch a web page
  const result = await proly.webFetch({ url: 'https://example.com' });
  console.log(result.content);

  // Search the web
  const results = await proly.webSearch({ query: 'best deals UK' });

  // Send a notification to the user
  await proly.callTool('messaging_notify', {
    title: 'Deal found!',
    body: 'Nike trainers 30% off at JD Sports',
  });
}

run();

Environment Variables

The SDK reads these automatically when running inside a Proly sandbox:

• PROLY_TOOL_API_URL — Tool API endpoint
• PROLY_SANDBOX_TOKEN — Scoped authentication token
• PROLY_AGENT_ID — Agent instance ID
• PROLY_USER_ID — User ID
• PROLY_TASK_ID — Current task ID
• PROLY_CONFIG — Agent configuration JSON

Local Development

Use proly dev to test locally:

proly dev --api-key your_api_key

Docs

https://proly.co.uk/developers