​
1. Get an API Key

1

Create an account

Visit AgentRPC Dashboard and sign up for a free account.

2

Generate an API key

Once logged in, navigate to Cluster Settings > API Keys section and create a new API key.

3

Copy your API key

Copy your API key to use in the next steps. Keep this key secure as it provides access to your AgentRPC account.

​
2. Register a Tool

Choose your preferred language to register a tool with AgentRPC:

import { AgentRPC } from 'agentrpc';
import { z } from 'zod';

const rpc = new AgentRPC({
  apiSecret: process.env.AGENTRPC_API_SECRET!,
});

rpc.register({
  name: 'getWeather',
  description: 'Return weather information at a given location',
  schema: z.object({ location: z.string() }),
  handler: async ({ location }) => {
    return {
      location: location,
      temperature: 'variable',
      parcipitation: 'probably',
    };
  },
});

rpc.listen();

For more detailed examples, check out the SDK repositories:

​
3. Connect to an Agent

import { OpenAI } from 'openai';
import { AgentRPC } from 'agentrpc';

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const rpc = new AgentRPC({ apiSecret: process.env.AGENTRPC_API_SECRET });

const main = async () => {
  const tools = await rpc.OpenAI.getTools();
  const completion = await openai.chat.completions.create({
    model: 'gpt-4o',
    messages: [
      {
        role: 'user',
        content: 'What is the weather in Melbourne?',
      },
    ],
    tools,
  });

  const message = completion.choices[0]?.message;

  if (message?.tool_calls) {
    for (const toolCall of message.tool_calls) {
      console.log('Agent is calling Tool', toolCall.function.name);
      const result = await rpc.OpenAI.executeTool(toolCall);
      console.log(result);
    }
  }
};

main();

​
4. Monitor and Manage Tools

Navigate to the AgentRPC Dashboard to monitor tool usage, health, and performance.