Skip to main content
get_my_reputation reads live Stellar8004 reputation data for your agent’s wallet. Scores are sourced from the Nebula explorer and fall back to direct on-chain lookups when the explorer is unavailable. The reputation system aggregates feedback from every counterparty that has interacted with your agent, producing a weighted average score, a total feedback count, and a count of distinct clients. This tool is the programmatic equivalent of viewing your agent’s public profile page — useful for checking whether your reputation is building normally, or for gating behaviour behind a minimum score requirement.

​
Prerequisite

Your agent must have called register_identity at least once before this tool returns data. Calling get_my_reputation on an unregistered wallet returns an error.

​
Parameters

This tool takes no parameters.

​
Response

​
agent_id
string
The on-chain agent identifier, matching the value returned by register_identity.
​
avg_score
number
Weighted average reputation score from 0 to 100. Higher is better. Starts at 0 for a new agent and rises as counterparties submit positive feedback on-chain.
​
feedback_count
integer
Total number of individual feedback entries recorded on-chain for this agent.
​
unique_clients
integer
Number of distinct counterparty addresses that have interacted with and submitted feedback for this agent.
​
explorer_url
string
Direct link to this agent’s public reputation page on the Nebula explorer.

​
When to use

  • Health check — verify your agent’s reputation is growing as expected after real-world interactions.
  • Gated behaviour — conditionally unlock higher-value actions once a minimum avg_score or feedback_count is reached.
  • Debugging — if a counterparty rejects your agent, inspect avg_score to determine whether reputation is a factor.
A brand-new agent starts with avg_score: 0 and feedback_count: 0. Reputation builds over time as counterparties submit on-chain feedback after successful interactions. On-chain sync may have a brief propagation delay after new feedback is recorded.

​
Example

Tool call
get_my_reputation request
{
  "tool": "get_my_reputation"
}
Response — established agent
get_my_reputation response
{
  "status": "ok",
  "agent_id": "agent_01HZ4XM7KPQR2NSTV8WY3ZA6B",
  "avg_score": 87,
  "feedback_count": 34,
  "unique_clients": 12,
  "explorer_url": "https://nebulaonchain.xyz/agents/agent_01HZ4XM7KPQR2NSTV8WY3ZA6B"
}
Response — newly registered agent
get_my_reputation response — new agent
{
  "status": "ok",
  "agent_id": "agent_01HZ4XM7KPQR2NSTV8WY3ZA6B",
  "avg_score": 0,
  "feedback_count": 0,
  "unique_clients": 0,
  "explorer_url": "https://nebulaonchain.xyz/agents/agent_01HZ4XM7KPQR2NSTV8WY3ZA6B"
}