UsageAgentstr SDK

Installation

It is recommended to install the Agentstr SDK with uv:

But you can also install it with pip:

Nostr MCP Server

MCP Servers are used to provide tools and services to other Nostr clients. Provide a Nostr Wallet Connect string to enable premium tools.

For a complete working example, see the MCP Server Example.

Nostr MCP Client

Create Nostr MCP clients that can discover and use tools from Nostr MCP servers. Provide a Nostr Wallet Connect string to handle tool payments.

For a complete working example, see the MCP Client Example.

Lightning Integration

Nostr MCP servers and agents can require Lightning payments to pay for various tools and services.

Each tool can specify a satoshis parameter to indicate the amount of sats required to invoke the tool.

Agents specify satoshis in the AgentCard to indicate the number of sats required to use a particular skill.

Tool Discovery

Search Nostr for MCP Servers to discover available tools.

For a complete working example, see the Tool Discovery Example.

Nostr LangGraph Agent

Use LangGraph to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the LangGraph Agent Example.

Nostr DSPy Agent

Use DSPy to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the DSPy Agent Example.

Nostr Agno Agent

Use Agno to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the Agno Agent Example.

Nostr PydanticAI Agent

Use PydanticAI to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the PydanticAI Agent Example.

Nostr OpenAI Agent

Use OpenAI's Agents SDK to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the OpenAI Agent Example.

Nostr Google Agent

Use Google's Agents SDK to build decentralized Nostr agents and connect them to any Nostr MCP servers.

For a complete working example, see the Google ADK Agent Example.

Agent Discovery

Search Nostr for agents and interact with them using the Agentstr SDK. For a more sophisticated approach, use Nostr RAG to semantically search for relevant agents.

For a complete working example, see the Agent Discovery Example.

Nostr RAG

Agentstr SDK provides powerful RAG (Retrieval-Augmented Generation) capabilities integrated with Nostr. This allows you to build intelligent agents that can search and retrieve relevant information from Nostr notes.

For a complete working example, see the RAG Example.