Build with Vyavsay

Before you start

• A key acts for the account that made it, and only that account. Send it in an Api-Key header.
• Most of the API needs a paid plan. Your account and plan, the upgrade link, and the scheme and filing-date checks work on any plan.
• Everything has the limits it has on vyavsay.ai, plus a cap on requests per hour. A 429 says when to try again; a 402 says which plan a feature needs.
• A generated site is a private draft. Only the owner can publish it, from vyavsay.ai, after verifying the Google listing.

Connect an AI agent (MCP)

The MCP server is at https://vyavsay.ai/mcp (Streamable HTTP). In Claude Code:

claude mcp add --transport http vyavsay https://vyavsay.ai/mcp \
  --header "Api-Key: vy_your_key"

In other clients that read an MCP config file:

{
  "mcpServers": {
    "vyavsay": {
      "type": "http",
      "url": "https://vyavsay.ai/mcp",
      "headers": { "Api-Key": "vy_your_key" }
    }
  }
}

40 tools

generate_site

Build a website for a business written from its reviews: from its Google Maps link (a preview that cannot be published), or with source google_business_profile and no link, from every review on the Business Profile its owner has connected (publishable). Returns a generation at once; poll get_generation until status is ready (then outputs.site_slug) or failed. The site is a private draft until the owner publishes it.

create_client

For agencies: create a business for a client who has not signed up yet (you own it until they claim it). Pass external_ref (your own id for the client): calling again with the same one returns the same client. place_id is the client's Google listing, used later to verify and publish.

list_clients

For agencies: your clients with status (unclaimed, claimed, verified, live), latest site and generation. Page with after = the previous response's next.

create_claim_invite

For agencies: a one-time link (valid 14 days) for the client to claim the business you made for them, after which you manage it and they own it. Send the link yourself. agency_name is shown to the client.

delete_client

For agencies: delete a client nobody has claimed yet, with its drafts and photos. Use it when the business opts out (preview.removed_by_business). A claimed client can't be deleted by you; leave it instead.

get_capabilities

What Vyavsay can build and what you have left: site tiers, themes, pages, languages, templates, the exact content shape of every section type for compose_site, live features, your plan and remaining allowances, and agency rate limits. Call this before composing a site.

get_client_page

The client's free page (vyavsay.ai/b/<slug>) as saved, or a draft to start from.

save_client_page

Save the client's free page as a draft (published stays false: only the owner publishes). page has slug, display_name, tagline, description, area, whatsapp, phone, email, hours, address, theme (clean, warm, bold), offerings [{name, price}].

get_plan_link

A link for the client to buy their own plan, which keeps their website online. Grants nothing by itself; ready is false until the client has claimed the business.

list_events

For agencies: what happened to your clients since the cursor `after` (the previous call's `next`), oldest first: client.created, generation.ready/failed, preview.viewed/expired/removed_by_business, claim.invite_opened/accepted/declined, listing.verified, site.published/unpublished, coverage.changed, manager.removed, client.deleted. Dedupe on id.

create_preview_share

A private link to a draft website made with compose_site, for the business to see before it is published. Returns url (shown once) and expires_at; days 1-30, default 14. made_by is shown on the page. Sites built from Google can't be shared.

get_preview_share

Whether a preview link was opened (views), when it ends, and its status: live, expired, revoked, or removed (the business ended it: treat as a no).

revoke_preview_share

End a preview link now.

compose_site

Create a draft website from content you write, for a business with no reviews to build from. sections is a list of {type, page?, content}: types hero, about, offerings, location, advantages, popular_items, special_touches, tips, faq, team, timetable, amenities, gallery, offers. No testimonials, ratings or claims of rank (best, No. 1). Pass place_id (the business's Google listing) so the owner can verify it and publish. Returns the draft's slug.

analyze_reviews

What customers praise and complain about, from the latest review analysis of the business's site. Every line cites the reviews it rests on. Run generate_site first if there is none.

set_section_image

Add an uploaded photo (upload_image) to a section, after the photos it already has.

connect_domain

Connect www.yourdomain.in to a site's business. Returns the DNS record to add; then call verify_domain.

account_info

The account's plan and what is left of it this period. Works on any plan.

create_subscription_checkout

A link for the account's owner to open and pay for a plan in the browser. Works on any plan.

list_businesses

The account's businesses, with their saved profile facts.

get_business

One business's profile.

create_business

Add a business by name; any other profile field (city, state, sector, ...) may be given too.

update_business

Change profile fields of a business (only the fields given).

get_generation

A generation's status, progress and, when ready, the site's slug.

list_sites

Every site on the account, the free page included.

get_site

A site as it would be published: settings and visible sections.

delete_site

Delete a generated site (not the free page). Cannot be undone.

export_site

A site as one HTML file, Markdown or JSON (Business and Agency plans).

list_sections

A site's sections, in order, with ids, content and photos.

get_section

One section.

update_section

Replace a section's content (same shape as get_section returns), show or hide it, set its photos (upload ids, in order), or its layout (get_capabilities → site.section_layouts lists the types with a choice).

update_site_style

Change a site's style (theme: one of get_capabilities → site.themes for its tier), its layout choices (design: any of site.design's keys, e.g. {"hero": "split", "width": "wide"}; keys left out keep their value), and on Premium its brand colour (#rrggbb) and logo (an upload id).

upload_image

Upload a JPEG, PNG or WebP to a site, as base64. Metadata such as location is stripped.

list_uploads

A site's uploaded photos.

delete_upload

Delete an uploaded photo.

add_domain

Connect www.yourdomain.in to a business; returns the DNS record to add.

verify_domain

Check whether the DNS record is in place and the certificate issued.

remove_domain

Disconnect the business's custom domain.

check_schemes

Eligibility for MUDRA, PMEGP and CGTMSE (and Stand-Up India, now closed), from rules in code with the date they were checked. Free on every plan.

filing_calendar

GST, TDS, PF, ESI, advance-tax and ITR due dates for a business's profile. Free on every plan.