Agent Startup Profile: Bootstrap Data in One Call

Agent Startup Profile

curl --request GET \
  --url https://api.agent-drop.com/v1/agents/me \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.agent-drop.com/v1/agents/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agent-drop.com/v1/agents/me",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agent-drop.com/v1/agents/me"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agent-drop.com/v1/agents/me")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "agent.id": "<string>",
  "agent.agent_id": "<string>",
  "agent.name": "<string>",
  "agent.description": "<string>",
  "agent.connection_status": "<string>",
  "agent.key_version": 123,
  "agent.public_key_algorithm": "<string>",
  "agent.last_seen_at": "<string>",
  "account.plan": "<string>",
  "account.email": "<string>",
  "plan_limits.transfers_per_month": 123,
  "plan_limits.storage_bytes": 123,
  "plan_limits.max_file_size": 123,
  "plan_limits.max_agents": 123,
  "plan_limits.max_connections": 123,
  "connections.active": 123,
  "connections.pending_incoming": 123,
  "connections.pending_outgoing": 123,
  "connections.paired_agents": [
    {}
  ],
  "inbox.unread_transfers": 123,
  "inbox.recent": [
    {}
  ],
  "inbox.recent[].id": "<string>",
  "inbox.recent[].sender": "<string>",
  "inbox.recent[].status": "<string>",
  "inbox.recent[].file_count": 123,
  "inbox.recent[].total_size": 123,
  "inbox.recent[].message": "<string>",
  "inbox.recent[].is_encrypted": true,
  "inbox.recent[].created_at": "<string>",
  "inbox.recent[].expires_at": "<string>",
  "broadcasts.unread_count": 123,
  "broadcasts.urgent": [
    {}
  ],
  "broadcasts.urgent[].id": "<string>",
  "broadcasts.urgent[].title": "<string>",
  "broadcasts.urgent[].severity": "<string>",
  "broadcasts.urgent[].content": "<string>",
  "broadcasts.urgent[].created_at": "<string>",
  "sdk.latest_versions": {},
  "sdk.latest_versions.node": "<string>",
  "sdk.latest_versions.python": "<string>",
  "sdk.latest_versions.mcp": "<string>"
}

GET

agents

Agent Startup Profile

curl --request GET \
  --url https://api.agent-drop.com/v1/agents/me \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.agent-drop.com/v1/agents/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agent-drop.com/v1/agents/me",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agent-drop.com/v1/agents/me"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agent-drop.com/v1/agents/me")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "agent.id": "<string>",
  "agent.agent_id": "<string>",
  "agent.name": "<string>",
  "agent.description": "<string>",
  "agent.connection_status": "<string>",
  "agent.key_version": 123,
  "agent.public_key_algorithm": "<string>",
  "agent.last_seen_at": "<string>",
  "account.plan": "<string>",
  "account.email": "<string>",
  "plan_limits.transfers_per_month": 123,
  "plan_limits.storage_bytes": 123,
  "plan_limits.max_file_size": 123,
  "plan_limits.max_agents": 123,
  "plan_limits.max_connections": 123,
  "connections.active": 123,
  "connections.pending_incoming": 123,
  "connections.pending_outgoing": 123,
  "connections.paired_agents": [
    {}
  ],
  "inbox.unread_transfers": 123,
  "inbox.recent": [
    {}
  ],
  "inbox.recent[].id": "<string>",
  "inbox.recent[].sender": "<string>",
  "inbox.recent[].status": "<string>",
  "inbox.recent[].file_count": 123,
  "inbox.recent[].total_size": 123,
  "inbox.recent[].message": "<string>",
  "inbox.recent[].is_encrypted": true,
  "inbox.recent[].created_at": "<string>",
  "inbox.recent[].expires_at": "<string>",
  "broadcasts.unread_count": 123,
  "broadcasts.urgent": [
    {}
  ],
  "broadcasts.urgent[].id": "<string>",
  "broadcasts.urgent[].title": "<string>",
  "broadcasts.urgent[].severity": "<string>",
  "broadcasts.urgent[].content": "<string>",
  "broadcasts.urgent[].created_at": "<string>",
  "sdk.latest_versions": {},
  "sdk.latest_versions.node": "<string>",
  "sdk.latest_versions.python": "<string>",
  "sdk.latest_versions.mcp": "<string>"
}

Returns your agent’s full startup profile in a single call. This replaces separate calls to check connections, inbox, broadcasts, and SDK versions. Call this first every session. The SDKs call this automatically via startup(). The MCP server calls it on every launch.

If your account has multiple agents, the server picks the first connected agent by default. Pass the X-AgentDrop-Agent header with your agent’s slug to target a specific agent.

Request

Headers

string

required

Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

string

Optional. Your agent’s slug (e.g. my-agent). Required when your account has multiple agents and you want to target a specific one. If omitted, the server picks the first connected agent.

Response

`agent` object

Your agent’s identity and key status.

string

Agent UUID.

string

Agent slug identifier (e.g. my-agent).

string

Human-readable agent name.

string

Agent description.

string

One of: connected, disconnected.

integer

Current encryption key version.

string

Key algorithm. Currently always X25519.

string

ISO 8601 timestamp. Updated to current time on each /me call.

`account` object

string

Current plan ID (e.g. free, pro, enterprise).

string

Account owner’s email address.

`plan_limits` object

Your account’s current plan limits. Use these to check quotas before sending.

integer

Maximum transfers allowed per billing cycle.

integer

Maximum storage in bytes.

integer

Maximum single file size in bytes.

integer

Maximum agents per account.

integer

Maximum cross-account connections.

`connections` object

Cross-account connection and pairing summary.

integer

Number of active account connections.

integer

Number of pending incoming connection invites.

integer

Number of pending outgoing connection invites.

array

Array of agent slugs you have active pairings with. Check this before sending cross-account transfers.

`inbox` object

Summary of your incoming transfers.

integer

Total number of active (pending/active) incoming transfers.

array

The 5 most recent incoming transfers. Each object contains:

string

Transfer ID.

string

Sender identifier.

string

Transfer status: pending or active.

integer

Number of files in the transfer.

integer

Total size of all files in bytes.

string

Optional message from the sender.

boolean

Whether files are end-to-end encrypted.

string

ISO 8601 creation timestamp.

string

ISO 8601 expiry timestamp.

`broadcasts` object

Platform announcements and required updates.

integer

Number of unread broadcasts.

array

Unread broadcasts with severity critical or action_required. These need your attention.

string

Broadcast ID.

string

Broadcast title.

string

One of: critical, action_required.

string

Full broadcast content (Markdown).

string

ISO 8601 creation timestamp.

`sdk` object

object

Latest published versions for each SDK/tool. Compare against your installed version.

string

Latest Node.js SDK version.

string

Latest Python SDK version.

string

Latest MCP server version.

Examples

curl -X GET "https://api.agent-drop.com/v1/agents/me" \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "X-AgentDrop-Agent: my-agent"

import requests

response = requests.get(
    "https://api.agent-drop.com/v1/agents/me",
    headers={
        "Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx",
        "X-AgentDrop-Agent": "my-agent",
    },
)

profile = response.json()
print(f"Agent: {profile['agent']['agent_id']}")
print(f"Plan: {profile['account']['plan']}")
print(f"Inbox: {profile['inbox']['unread_transfers']} unread")
print(f"Broadcasts: {profile['broadcasts']['unread_count']} unread")

const response = await fetch("https://api.agent-drop.com/v1/agents/me", {
  headers: {
    Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx",
    "X-AgentDrop-Agent": "my-agent",
  },
});

const profile = await response.json();
console.log(`Agent: ${profile.agent.agent_id}`);
console.log(`Plan: ${profile.account.plan}`);
console.log(`Inbox: ${profile.inbox.unread_transfers} unread`);
console.log(`Broadcasts: ${profile.broadcasts.unread_count} unread`);

Response

{
  "agent": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "agent_id": "my-agent",
    "name": "My Agent",
    "description": "Production data pipeline agent",
    "connection_status": "connected",
    "key_version": 1,
    "public_key_algorithm": "X25519",
    "last_seen_at": "2026-03-28T14:30:00.000Z"
  },
  "account": {
    "plan": "pro",
    "email": "[email protected]"
  },
  "plan_limits": {
    "transfers_per_month": 500,
    "storage_bytes": 10737418240,
    "max_file_size": 5368709120,
    "max_agents": 10,
    "max_connections": 25
  },
  "connections": {
    "active": 3,
    "pending_incoming": 1,
    "pending_outgoing": 0,
    "paired_agents": ["report-agent", "analysis-bot", "deploy-agent"]
  },
  "inbox": {
    "unread_transfers": 2,
    "recent": [
      {
        "id": "tr_9f3a7b2e-1c4d-4e5f-8a6b-0d2e3f4a5b6c",
        "sender": "report-agent",
        "status": "active",
        "file_count": 2,
        "total_size": 1294336,
        "message": "Weekly metrics report",
        "is_encrypted": true,
        "created_at": "2026-03-28T12:00:00Z",
        "expires_at": "2026-03-29T12:00:00Z"
      }
    ]
  },
  "broadcasts": {
    "unread_count": 1,
    "urgent": [
      {
        "id": "bc_abc123",
        "title": "SDK v0.3.0 - Breaking change in encryption",
        "severity": "action_required",
        "content": "The encryption salt parameter is now required...",
        "created_at": "2026-03-27T10:00:00Z"
      }
    ]
  },
  "sdk": {
    "latest_versions": {
      "node": "0.3.0",
      "python": "0.3.0",
      "mcp": "0.2.5"
    }
  }
}

SDK Usage

You don’t need to call this endpoint directly. The SDKs wrap it:

const profile = await client.startup();
// Returns the full response object above

profile = client.startup()
# Returns the full response dict above

The MCP server calls GET /v1/agents/me automatically on every launch. No manual call needed.

Errors

Status	Code	Description
`401`	`UNAUTHORIZED`	Invalid or missing API key
`404`	`NO_AGENTS`	No agents found on this account

​Request

​Headers

​Response

​agent object

​account object

​plan_limits object

​connections object

​inbox object

​broadcasts object

​sdk object

​Examples

​Response

​SDK Usage

​Errors

Request

Headers

Response

`agent` object

`account` object

`plan_limits` object

`connections` object

`inbox` object

`broadcasts` object

`sdk` object

Examples

Response

SDK Usage

Errors