Tools reference

MCP Tools Reference

Complete reference for all 5 Pulsar MCP tools.

---

1. list_all_channels

List all Telegram channels that Pulsar is currently monitoring.

Parameters

None

Returns

Formatted string containing all available channels with names and usernames

How to Use

Ask your agent:

• "List all channels"

• "What channels do you monitor?"

• "Show me available channels"

Example Response

Pulsar monitors 25+ crypto Telegram channels:

• Fetch.ai (@Fetch_ai) - AI agent infrastructure
• Virtuals Protocol (@virtuals) - Virtual agents and gaming  
• Solana (@solana) - High-performance blockchain
• Toncoin (@toncoin) - TON blockchain
• Ocean Protocol (@oceanprotocol_community) - Data marketplace
• SingularityNET (@singularitynet) - Decentralized AI
• Curve Finance (@curvefi) - DeFi protocol
...

Use channel names or IDs in other tools.

Use Cases

• Discover available channels

• Get channel IDs for other tools

• Check channel usernames

---

2. get_channel_summary

Get the latest 12-hour summary or summaries for a specific Telegram channel.

Parameters

Parameter	Type	Required	Description
channel_id	string	Yes	Channel name (e.g., 'virtuals', '@virtuals', or numeric ID)
start_time	string	No	Start time in ISO format
end_time	string	No	End time in ISO format
limit	integer	No	Max summaries to return (default: 10)

Returns

Formatted summaries with topics, keywords, and key developments

How to Use

Ask your agent:

• "Summarize Virtuals Protocol"

• "What's the latest from Fetch.ai?"

• "Show me recent updates in Solana"

Example Response

=== Virtuals Protocol Summary ===
Period: 2025-01-15T18:00:00Z to 2025-01-16T06:00:00Z

📊 Key Developments:

1. MetaInsideAI 20x Growth
   Community discussing agent that generated 20x returns in first week
   Keywords: AI, agent, trading, returns

2. veVIRTUALS Staking Rewards
   Increased rewards for governance participants announced
   Keywords: staking, veVIRTUALS, governance

3. Gaming Partnership Rumors
   Unconfirmed talks with major gaming platform
   Keywords: partnership, gaming, integration

🔑 Period Keywords: AI, agent, staking, rewards, gaming, partnership

📈 Community Growth: +127 members (4,287 → 4,414)

Use Cases

• Get latest updates for a channel

• Track channel activity over time

• Monitor community developments

Notes

• When to use: User asks for "summary", "latest updates", "what happened in [channel]"

• Accepts channel names, @usernames, or numeric IDs

• Leave start_time/end_time empty for latest summaries

---

3. list_available_summaries

List all available summaries across all monitored channels.

Parameters

Parameter	Type	Required	Description
limit	integer	No	Max summaries to return (default: 50)

Returns

Formatted string containing available summaries across all channels

How to Use

Ask your agent:

• "Show me recent activity across all channels"

• "Which channels have new summaries?"

• "What's been happening lately?"

Example Response

Found 156 summaries across 25 channels:

**Available Channels:**
• Fetch.ai (@Fetch_ai) (ID: 2573725569)
• Virtuals Protocol (@virtuals) (ID: 1234567890)
• Solana (@solana) (ID: 1290362028)
• Toncoin (@toncoin) (ID: 1233043722)
...

**Recent Summaries (showing first 10):**
• Fetch.ai: 2025-01-15T18:00:00Z to 2025-01-16T06:00:00Z (success)
• Virtuals Protocol: 2025-01-15T18:00:00Z to 2025-01-16T06:00:00Z (success)
• Solana: 2025-01-15T18:00:00Z to 2025-01-16T06:00:00Z (success)
...

Use Cases

• Discover which channels have recent activity

• Get overview of all monitored communities

• Find channels to query

---

4. search_summaries_by_topic

Search summaries containing specific topic keywords.

Parameters

Parameter	Type	Required	Description
topic_keywords	array of strings	Yes	Keywords to search for
start_time	string	No	Start time in ISO format
end_time	string	No	End time in ISO format
limit	integer	No	Max results (default: 20)

Returns

Formatted string containing matching summaries

How to Use

Ask your agent:

• "Find summaries about staking rewards"

• "Search for airdrop announcements"

• "What channels are discussing partnerships?"

Example Response

Found 8 summaries matching 'staking, rewards, airdrop':

--- Toncoin (2025-01-15T18:00:00Z to 2025-01-16T06:00:00Z) ---
• New 15% APY staking program announced with 30-day lock period
• Community discussing reward distribution mechanism
• Questions about minimum staking amounts

--- Solana (2025-01-15T06:00:00Z to 2025-01-15T18:00:00Z) ---
• Liquid staking options now available for flexibility
• Comparison of staking rewards across different validators
...

Use Cases

• Find discussions about specific topics (e.g., "airdrop", "token launch")

• Track recurring themes across channels

• Monitor sentiment around keywords

---

5. semantic_search_messages

Perform semantic search across Telegram messages using natural language.

Parameters

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
channel_filter	string	No	Filter by channel ID, username, or @username
start_time	string	No	Start time in ISO format
end_time	string	No	End time in ISO format
limit	integer	No	Max results (default: 10)

Returns

Formatted string containing matching messages with relevance scores

How to Use

Ask your agent:

• "What are the latest AI agent developments?"

• "Find messages about staking rewards"

• "What's being said about token launches?"

Example Response

Found 5 messages matching 'What are the latest AI agent developments?':

--- Channel 2573725569 @ 2025-01-15T14:30:00Z (relevance: 0.89) ---
Sender: Admin
Content: 🎉 Exciting news! We're launching a new AI agent marketplace. 
Agents will be able to autonomously trade, provide research, and manage 
portfolios. Beta testing starts next week...

--- Channel 1234567890 @ 2025-01-15T12:15:00Z (relevance: 0.85) ---
Sender: Developer
Content: Just deployed our autonomous trading agent. It's analyzing 
sentiment across 50+ channels and executing trades based on community 
signals. Early results are promising...

Use Cases

• Answer natural language questions about channel discussions

• Find relevant messages without exact keyword matching

• Discover context around specific topics

Notes

• Uses OpenAI embeddings for semantic understanding

• Matches meaning, not just keywords

• Example: "AWS outage" matches "Amazon Web Services downtime"

---

Tool Selection Guide

For Latest Updates:

• Use get_channel_summary or list_available_summaries

For Specific Topics:

• Use search_summaries_by_topic

For Natural Language Questions:

• Use semantic_search_messages

• Supports optional channel_filter for channel-specific search

• Supports optional start_time/end_time for time-based search

To Discover Channels:

• Use list_all_channels

---

Common Patterns

Get Latest News Across All Channels

Ask: "Show me recent activity across all channels" or "What's been happening lately?"

Uses: list_available_summaries

Monitor Specific Topic

Ask: "Find discussions about airdrops and token launches"

Uses: search_summaries_by_topic

Answer User Questions

Ask: "What are people saying about AI agents?"

Uses: semantic_search_messages

Track Channel Over Time

Ask: "Show me Virtuals Protocol activity from January 1st to 15th"

Uses: get_channel_summary with date range

---

Error Handling

All tools return error messages in the response text if something goes wrong:

Error: Failed to fetch summaries for channel unknown_channel

No messages found matching query: xyz123

Error retrieving summaries: Connection timeout

Handle these gracefully in your agent logic.

---

Rate Limits

• 60 requests per minute with bearer token

• Burst allowance up to 100 requests

• Returns error message if exceeded

→ See Authentication for details