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

PreviousQuick start

Last updated