Build with 114+ AI Specialists

import requests

API_KEY  = 'urb_dev_your_key_here'
BASE_URL = 'https://urbot.net/api/v1'

def ask_bot(bot_slug, message, conversation_id=None):
    r = requests.post(
        f'{BASE_URL}/chat',
        headers={'X-API-Key': API_KEY},
        json={
            'bot_slug':        bot_slug,
            'message':         message,
            'conversation_id': conversation_id,
        }
    )
    r.raise_for_status()
    return r.json()

# Single call
result = ask_bot('legal', 'What is an NDA?')
print(result['response'])
print(f"Credits remaining: {result['credits_remaining']}")

# Multi-turn
session = None
r1 = ask_bot('medic', 'What causes dehydration?')
session = r1['conversation_id']
r2 = ask_bot('medic', 'What are the best treatments?', session)

// urbot-client.js
const BASE = 'https://urbot.net/api/v1';

class URBotClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.sessions = {};
  }

  async chat(botSlug, message, opts = {}) {
    const sessionKey = opts.sessionKey || botSlug;
    const res = await fetch(`${BASE}/chat`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-API-Key': this.apiKey,
      },
      body: JSON.stringify({
        bot_slug:        botSlug,
        message,
        conversation_id: this.sessions[sessionKey] || null,
        system_context:  opts.systemContext || null,
      }),
    });
    if (!res.ok) throw new Error(`URBot API error: ${res.status}`);
    const data = await res.json();
    this.sessions[sessionKey] = data.conversation_id;
    return data;
  }

  clearSession(botSlug) {
    delete this.sessions[botSlug];
  }
}

// Usage
const client = new URBotClient(process.env.URBOT_API_KEY);

const r1 = await client.chat('chef', 'What pasta goes well with pesto?');
const r2 = await client.chat('chef', 'Give me a recipe for 4 people');
// r2 remembers r1 context automatically

curl -X POST https://urbot.net/api/v1/chat \
  -H "X-API-Key: urb_dev_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_slug": "medic",
    "message":  "What are symptoms of dehydration?"
  }'

curl -X POST https://urbot.net/api/dev/keys \
  -H "Content-Type: application/json" \
  -d '{
    "name":  "My App",
    "email": "you@example.com",
    "plan":  "free"
  }'

curl "https://urbot.net/api/dev/keys?email=you@example.com"

curl -X DELETE \
  "https://urbot.net/api/dev/keys/KEY_UUID_HERE?email=you@example.com"

curl -X POST \
  "https://urbot.net/api/dev/keys/KEY_UUID_HERE/rotate?email=you@example.com"

curl "https://urbot.net/api/dev/usage/KEY_UUID_HERE"

curl "https://urbot.net/api/products"

curl "https://urbot.net/api/health"

const MCP_URL = 'https://urbot.net/api/mcp';
const API_KEY = 'urb_dev_your_key_here';

async function mcpCall(method, params = {}) {
  const res = await fetch(`${MCP_URL}/${method.replace('/', '/')}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY
    },
    body: JSON.stringify({ jsonrpc: '2.0', id: Date.now(), method, params })
  });
  const data = await res.json();
  if (data.error) throw new Error(data.error.message);
  return data.result;
}

// Initialize
const info = await mcpCall('initialize', {
  protocolVersion: '2024-11-05',
  clientInfo: { name: 'my-app', version: '1.0' }
});
console.log('Connected to', info.serverInfo.name);

// Chat with a bot
const result = await mcpCall('tools/call', {
  name: 'chat_with_bot',
  arguments: { botSlug: 'medic', message: 'What causes dehydration?' }
});
console.log(result.content[0].text);

// Search bots
const search = await mcpCall('tools/call', {
  name: 'search_bots',
  arguments: { query: 'legal advice' }
});
const bots = JSON.parse(search.content[0].text).bots;
console.log('Found:', bots.map(b => b.name).join(', '));

import requests, json

MCP_URL = 'https://urbot.net/api/mcp'
API_KEY = 'urb_dev_your_key_here'
_id = 0

def mcp(method, params=None):
    global _id
    _id += 1
    endpoint = method.replace('/', '/')
    r = requests.post(
        f'{MCP_URL}/{endpoint}',
        headers={'Content-Type': 'application/json', 'X-API-Key': API_KEY},
        json={'jsonrpc': '2.0', 'id': _id, 'method': method, 'params': params or {}}
    )
    data = r.json()
    if 'error' in data:
        raise Exception(data['error']['message'])
    return data['result']

# Initialize
info = mcp('initialize', {'protocolVersion': '2024-11-05', 'clientInfo': {'name': 'my-app'}})
print('Server:', info['serverInfo']['name'])

# Chat with chef bot
result = mcp('tools/call', {
    'name': 'chat_with_bot',
    'arguments': {'botSlug': 'chef', 'message': 'Best herbs for Italian cooking?'}
})
print(result['content'][0]['text'])

# List all bots
bots_result = mcp('tools/call', {'name': 'list_bots', 'arguments': {}})
bots = json.loads(bots_result['content'][0]['text'])['bots']
print(f'Total bots: {bots[\"total\"]}')