Beta

AvenueD MCP

Point an AI agent at your community over MCP (Model Context Protocol) and let it read stats, run raffles, send rewards, and moderate content, scoped to your community only.

Compatibility

Works today with Claude Code and any MCP-compatible CLI that can speak streamable HTTP MCP with a Bearer token.

Claude.ai and ChatGPT custom connectors are not supported yet. Both require OAuth 2.1 plus RFC 7591 dynamic client registration, which is a later phase of this work.

Status

Endpoint	Beta	https://www.aved.ai/api/mcp
Auth	Beta	Bearer token, SHA-256 hashed keys
Transport	Beta	Stateless JSON-RPC 2.0 over HTTP POST
Claude Code	Beta	Works today via a plain HTTP MCP server entry
MCP CLIs	Beta	Any client that speaks streamable HTTP MCP
Claude.ai connector	Not available	Needs OAuth 2.1 + dynamic client registration
OAuth DCR	Not available	RFC 7591, not built yet

64 tools, by category

89 tools exist on the platform. 64 are available to a community API key. The rest are superadmin-only and not exposed here.

Insights & reporting9 tools

Read-only snapshots for briefings, dashboards, and sanity checks before any write.

9 read

Members6 tools

Look up and moderate members. Always search before sending rewards or changing roles.

5 read1 write

Missions8 tools

Full lifecycle: create, fund, track submissions, change status, archive.

4 read4 write

Clip rewards5 tools

CPM clipping campaigns: create, fund, review submissions, verify views, pay.

2 read3 write

Raffles6 tools

Create, check treasury, draw winners, archive.

3 read3 write

Games & tournaments11 tools

Parlays and bracket tournaments. Set results, then select winners.

7 read4 write

Rewards & treasury7 tools

Check balance first. All writes are pool- or treasury-gated.

3 read4 write

Posts & social4 tools

Read the feed, post, announce, moderate.

2 read2 write

Moderation3 tools

Review flagged content, act on reports.

2 read1 write

Community settings4 tools

Update branding, basics, privacy.

1 read3 write

Outbound email1 tools

Email specific users or the whole community.

0 read1 write

Full tool catalog

Insights & reporting9 tools

read

avenued_get_stats

Daily platform metrics: new users, engagement, rewards, failed transfers.

read

avenued_get_community_overview

Dashboard rollup: members, active missions, open raffles, recent posts.

read

avenued_get_community_growth

Member join timeline for charting growth trends.

read

avenued_get_community_completeness

Setup score — which onboarding pieces are still missing.

read

avenued_get_behavior_analytics

Behavior metrics, conversion funnel, user segmentation.

read

avenued_get_recent_activity

Last 10 notable events: new users, completions, raffle draws, posts.

read

avenued_get_reward_statistics

Total rewards distributed, recipients, averages, source breakdown.

read

avenued_get_top_earners

Top reward earners over an optional date window.

read

avenued_list_communities

Community health: member counts, active missions, daily active users.

Members6 tools

read

avenued_list_members

Paginated member list with username and role.

read

avenued_search_members

Prefix search by username — use before writes that target a user.

read

avenued_get_user

Member profile + recent reward history.

read

avenued_find_user_by_email

Resolve a user by email address.

read

avenued_list_users

Stats views: summary, inactive, churn risk.

write

avenued_update_member_rolemembers:write

Promote/demote a member (admin, moderator, member).

Missions8 tools

read

avenued_list_missions

Missions with completion counts and pool balances. Filter by status.

read

avenued_get_mission

Single mission detail with pool + entries.

read

avenued_list_mission_submissions

Submissions (community_posts tagged with mission_id).

read

avenued_list_mission_entries

Completion records with user info.

write

avenued_create_missionmissions:write

Create a mission, optionally allocating pool in the same call. Treasury-gated.

write

avenued_update_mission_statusmissions:write

draft → scheduled → active → paused → completed → archived.

write

avenued_archive_missionmissions:write

Archive or soft-delete a mission.

write

avenued_mark_mission_entry_fulfilledmissions:write

Mark a mission entry as fulfilled after delivering an external reward manually.

Clip rewards5 tools

read

avenued_list_clip_campaigns

Clip campaigns with status, config, and reward pool budget used/total.

read

avenued_list_clip_submissions

Clip submissions, filterable by campaign and payout status.

write

avenued_create_clip_campaignclip_rewards:write

Create a CPM clip campaign and fund its reward pool. Treasury-gated.

write

avenued_set_clip_view_countclip_rewards:write

Record a verified view count for a clip and compute its payout. Does not move money.

write

avenued_pay_clipclip_rewards:writedestructive

Confirm payout for a verified clip — executes the on-chain AVED transfer.

Raffles6 tools

read

avenued_list_raffles

Raffles with entry and winner counts.

read

avenued_get_raffle

Full raffle detail with current signups.

read

avenued_get_raffle_winners

Winners of a drawn raffle with user info.

write

avenued_create_raffleraffles:write

Create a custom raffle. Treasury-gated for AVED prizes.

write

avenued_draw_raffleraffles:writedestructive

Execute draw + distribute prizes on-chain. Only call after deadline. Irreversible.

write

avenued_archive_raffleraffles:write

Archive or soft-delete a raffle.

Games & tournaments11 tools

read

avenued_list_parlays

Parlays with entry and winner counts.

read

avenued_get_parlay

Parlay detail with ranked entries.

read

avenued_get_parlay_winners

Parlay winners with their predictions.

write

avenued_set_parlay_resultsgames:write

Set game scores and calculate rankings.

write

avenued_select_parlay_winnersgames:writedestructive

Select winners by ordered list of user IDs. Distributes prizes.

write

avenued_archive_parlaygames:write

Archive a parlay.

write

avenued_delete_parlaygames:writedestructive

Hard-delete a parlay. Irreversible.

read

avenued_list_tournaments

Bracket tournaments with entry counts.

read

avenued_get_tournament

Tournament with teams and matchups.

read

avenued_get_tournament_leaderboard

Tournament rankings with user info.

read

avenued_get_tournament_winners

Winners with reward details.

Rewards & treasury7 tools

read

avenued_get_treasury_balance

Live on-chain AVED + USDC balance.

read

avenued_get_rewards

Reward distribution views: summary, pending, failed, allocations.

read

avenued_get_pending_transfers

Pending / processing / failed payouts.

write

avenued_allocate_poolrewards:writedestructive

Allocate tokens to a mission/raffle/game pool. Treasury-gated.

write

avenued_send_direct_rewardrewards:writedestructive

One-off AVED to a single user (source: admin_grant). On-chain transfer.

write

avenued_send_bulk_rewardrewards:writedestructive

Same AVED amount to multiple users in one call. On-chain transfers.

write

avenued_withdraw_from_treasuryrewards:writedestructive

Withdraw AVED or USDC from the treasury to any wallet. Irreversible.

Posts & social4 tools

read

avenued_list_posts

Recent community posts, newest first.

read

avenued_get_post

Post detail with comment thread.

write

avenued_create_postposts:write

Create a community post (social content, updates).

write

avenued_announceposts:write

Create a pinned admin announcement post.

Moderation3 tools

read

avenued_get_moderation

Pending reports and hidden posts.

read

avenued_list_reported_comments

Pending comment reports (moderation queue).

write

avenued_moderatemoderation:write

Hide a post/comment or resolve a report.

Community settings4 tools

write

avenued_update_community_basicssettings:write

Name, headline, description, social URLs.

write

avenued_update_community_visualssettings:write

Logo and banner URLs.

write

avenued_update_community_settingssettings:write

Privacy type, pricing, access flags.

read

avenued_list_api_keys

List API keys for this community (metadata only — no secrets).

Outbound email1 tools

write

avenued_send_emailemail:writedestructive

Custom email to specific users or the entire community. Cannot be unsent.

Scopes and permissions

Every key can call every read tool. Write access is granted per category, not all-or-nothing: an API key only gets the write scopes it was explicitly issued, so a raffle bot can be given raffles:write without also being able to send rewards or edit community settings.

missions:write

Create, update, and archive missions.

clip_rewards:write

Create clip campaigns, verify view counts, and confirm payouts.

raffles:write

Create, draw, and archive raffles.

games:write

Set parlay results, select winners, manage parlays.

rewards:write

Allocate pools, send rewards, withdraw from treasury. High blast radius.

posts:write

Create community posts and announcements.

moderation:write

Hide content and resolve reports.

members:write

Promote and demote members.

settings:write

Update branding, basics, privacy, and access settings.

email:write

Send emails to members. Cannot be unsent.

Get a key

As a community admin, open your community's admin panel, go to Settings → Automations, and create a key:

/<your-community-slug>/admin/settings?tab=automations

Pick a read-only or read+write preset (or choose specific write scopes yourself), set an optional expiry, and copy the key. It is shown once.

Copy-paste config

The transport is stateless JSON-RPC 2.0 over HTTP POST. There is no SSE channel; GET returns 405 by design.

.mcp.json

{
  "mcpServers": {
    "avenued": {
      "type": "http",
      "url": "https://www.aved.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Smoke test

curl -X POST "https://www.aved.ai/api/mcp" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

The Accept: application/json, text/event-stream header is required. This route has no Accept-header shim.

Rate limits

120 requests per minute per key, burstable up to 120 and refilling at 2 requests per second (token bucket). Exceeding it returns a retry-after value rather than a hard error, so batch your work instead of polling in a tight loop.

Included with your account. Learn more about AvenueD