Skip to main content
Glama

strands-hub-mcp

MCP server that exposes strands-hub data from S3:

  • Registry - list/update agents

  • Prompts - get/create prompt versions

  • Sessions - browse session data (read-only)

  • Metrics - query run metrics (read-only)

Prerequisites

  • Python 3.10+

  • AWS credentials configured (~/.aws/credentials or env vars)

  • S3 bucket with strands-hub data

Related MCP server: s3-mcp

Claude Code Integration

claude mcp add strands-hub-mcp --scope user \
  -e USE_S3=true \
  -e AGENT_HUB_BUCKET=your-bucket-name \
  -e AGENT_HUB_REGION=us-east-1 \
  -- uv --directory /path/to/strands-hub-mcp run strands-hub-mcp

Verify:

claude mcp list

Available Tools

Tool

Description

hub_status

Show current hub configuration

registry_list_agents

List all registered agents

registry_get_agent

Get agent details

registry_update_metadata

Update agent metadata

prompts_get_current

Get current prompt for an agent

prompts_get_version

Get specific prompt version

prompts_list_versions

List all prompt versions

prompts_create_version

Create new prompt version (append-only)

metrics_list

List metrics by date/agent

metrics_get

Get specific metrics record

sessions_list

List all sessions

sessions_get_session_json

Get session metadata

sessions_list_agents

List agents in a session

sessions_get_agent_json

Get agent data from session

sessions_list_messages

List messages in a session

sessions_get_message_json

Get specific message

Environment Variables

Variable

Required

Description

USE_S3

Yes

Must be true

AGENT_HUB_BUCKET

Yes

S3 bucket name

AGENT_HUB_REGION

Yes

AWS region

Author

Built by Du'An Lightfoot (@labeveryday)

Available Tools

17 tools
hub_statusA

Return the effective hub configuration (sanitized) used by this server.

Inputs: no named parameters.

metrics_getA

Fetch a metrics JSON object by S3 key.

Inputs: s3_key (required).

metrics_listC

List metrics objects in S3.

Inputs: limit, agent_id, date_prefix, continuation_token.

prompts_create_versionA

Create a new prompt version (append-only). Does NOT modify current.txt.

  • Fails if the version already exists.

  • Updates versions.json without changing its current pointer.

Inputs: content (required), version (required), agent_id (required), note.

prompts_get_currentC

Get the current system prompt content for an agent (cached locally by strands-hub).

Inputs: agent_id (required), force_refresh. Returns: result

prompts_get_versionC

Get a specific system prompt version content for an agent.

Inputs: version (required), agent_id (required). Returns: result

prompts_list_versionsB

List prompt versions for an agent from S3 (versions.json if present).

Inputs: agent_id (required).

registry_get_agentB

Get a single agent registry entry.

Inputs: agent_id (required). Returns: result

registry_list_agentsA

List registered agents (optionally filtered by tag).

Inputs: tag. Returns: result

registry_update_metadataB

Update allowlisted metadata fields for an existing agent.

Inputs: agent_id (required), tags, owner, model_id, +3 more. Returns: result

sessions_get_agent_jsonB

Fetch and parse sessions/<session_id>/agents/<agent_id>/agent.json.

Inputs: session_id (required), agent_id.

sessions_get_message_jsonC

Fetch and parse a message JSON object.

message_key may be either a basename like message_0.json or a full S3 key.

Inputs: session_id (required), message_key (required), agent_id.

sessions_get_rawA

Fetch a session object by S3 key and return parsed JSON when possible.

This is intentionally "raw" because session format is owned by strands-agents.

Inputs: s3_key (required).

sessions_get_session_jsonA

Fetch and parse sessions/<session_id>/session.json.

Inputs: session_id (required).

sessions_listC

List session IDs (prefixes) under sessions/.

Uses S3 CommonPrefixes (Delimiter="/") so it matches aws s3 ls s3://.../sessions/.

Inputs: limit, continuation_token.

sessions_list_agentsB

List agent IDs under sessions/<session_id>/agents/.

Inputs: session_id (required), limit, continuation_token.

sessions_list_messagesB

List message keys under sessions/<session_id>/agents/<agent_id>/messages/.

Inputs: session_id (required), limit, agent_id, continuation_token.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools map to distinct resources and actions, with clear domain prefixes (registry, prompts, metrics, sessions). However, sessions_get_session_json and sessions_get_raw both fetch session data and could be confused, as could registry_get_agent vs sessions_get_agent_json despite their different contexts.

    Naming Consistency4/5

    Naming follows a consistent <domain>_<verb>_<object> pattern for nearly all tools, such as registry_list_agents and sessions_get_message_json. The main deviation is hub_status, which lacks a verb unlike the rest, and sessions_get_raw uses an adjective instead of a specific object.

    Tool Count4/5

    17 tools is slightly above the typical well-scoped range, but the count is justified by the five distinct domains and the deep session hierarchy. Each tool serves a specific retrieval task, making the count reasonable rather than bloated.

    Completeness4/5

    The read-focused surface is fairly complete for inspection: sessions are traversable from ID down to message content, prompts have version listing/creation, and metrics are accessible. Minor gaps include no delete/create in the registry and no write operations for sessions, but these may be intentionally outside the server's scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers