PabandiOS

Lookup the status of a pending A2A negotiation proposal by proposalId.

Autonomous Agent-to-Agent (A2A) booking negotiation. Connects with Pabandi AI Concierge to propose a reservation, verify trust score, calculate dynamic escrow terms, and trigger merchant A2H approval when necessary. Returns proposalId, status, and escrow parameters.

Subscribe agent to proactive Pabandi alerts: flash inventory slots, no-show/risk score alerts, and escrow settlement milestones. Supports webhook push.

Get an agent's A2A agent card (.well-known/agent.json equivalent). Returns capabilities, skills, trust score, and contact info for agent-to-agent discovery.

Get the agent registry listing all discoverable agents on Pabandi. Returns agent handles, trust scores, and capabilities.

Book a high-ticket contractor milestone (e.g., Chicago Roofing, HVAC, or Commercial Security) with dynamic Trust-Band escrow pricing (Band A = $0 waived, Band B = 50% off, Band C = Standard, Band D = 1.25x capped at 50%). Returns reservationId, computed deposit, and Solana USDC escrow URI.

Reserve or lease a property unit/stay experience in PropertyOS on behalf of a tenant or guest. Automatically verifies tenant trust risk band via CourtListener, allocates lease deposit into escrow, and issues a cNFT booking pass.

Create a confirmed stay reservation for a property: links the existing Reservation model + a StayBooking, then holds the guest deposit in escrow (EscrowEvent + TreasuryPosition with kind:hospitality, Solana commitment, PTP attestation). The guest deposit is the trust anchor — released to the business on check-in, refunded on cancellation. This is the hospitality money rail. [verified] Gated to businesses with an attested open-finance settlement rail OR PTP Band A/B, so every booked stay has a real, verified payout path. This is what makes the hospitality vertical trustworthy to guests and exclusive to quality hosts. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Cancel an active booking by bookingId, update its cNFT credential status to CANCELLED, and release the time slot to the waitlist.

Check available appointment time slots and operating hours for a business on a specific date (YYYY-MM-DD). Returns open slots, booked slots, and business hours.

Check a counterparty's Trust Passport before bidding. Returns trustScore, tier, verifiedIdentity, and whether they clear a minimum score (default 500). Used by agents to evaluate who to transact with.

Returns the Sharia compliance status, audit certificates, and prohibited feature flags for the Pabandi platform.

Register a verifiable, masked settlement connection for a business: RAAST (Pakistan), Stripe Treasury, Open Banking, Solana wallet, or PayPal. The account reference is masked (never raw), and a PTP attestation is produced so the business can prove it has a real payout path without exposing the account. This is the open-finance connectivity primitive — the trust badge on a listing. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Create a verified booking for an agent or customer. Automatically mints a Solana State-Compressed NFT (cNFT) Booking Credential and generates a Solana Pay transfer request (USDC/PAB) with an on-chain reference key for 400ms automatic settlement detection via findReference.

Create an escrow for an agent-to-agent deal. Locks funds in escrow until the deliverable is verified. Returns escrowId, status, and amount locked. Price: 0.5% of escrow amount.

Create an orchestrated, multi-rail payment request. Automatically selects optimal rail (Solana USDC, SBP Raast, Card, Mobile Money) with automatic failover, double-entry ledgering, and optional AAOIFI Sharia compliance.

Create a dynamic milestone quote with programmable escrow for service businesses & contractors. Break down projects into phases (e.g. 30% deposit, 35% rough-in, 35% signoff) and generate a shareable checkout URL supporting Square, Solana Pay (USDC), and Raast.

Get PTP discovery (public). Returns verify endpoint, public key, issue endpoint, risk bands, entity types. No auth required.

Discover agents by skills, trust score, and location. Returns agents sorted by relevance with trust scores and capability badges.

Discover the full Pabandi Platform: every tool, OpenAPI/spec URL, MCP endpoint, PTP endpoints, SDK info, access tiers, and live status.

Scrapes a website and government registries (GLEIF, OpenCorporates) to find contact info, tech stack, and legal verification for a business. Use this before onboarding a new business to verify their legitimacy.

Check escrow balance and status. Returns status, totalAmount, releasedAmount, and platformFee.

Create a child sub-escrow from a master escrow (parent-child subcontracting). Allocates a portion of master funds to a subcontractor. Returns childEscrowId and amount allocated.

Lock funds in escrow (allocate memory). Creates a new escrow and funds it. Returns escrowId, status, and amount locked. This is the primitive agents use to put money on hold before work begins.

Release locked escrow funds to the recipient. Requires escrowId. Deducts a 5% platform settlement rake and routes net payout to payee while recording platform revenue into the autonomous treasury.

Check and trigger waterfall settlement for parent-child escrows. When all child escrows are released, the master escrow is marked completed. Returns settlement status.

Spend against an open PabandiSession -- book a service, pay an invoice, or fund an escrow. REQUIRES a sessionId. Sessions are authorised once against a Trust-Score-derived limit and let you transact repeatedly without a wallet signature per call, which is the entire point. If you do not have a session, call pabandi_open_session first and use the sessionId it returns; this tool will refuse without one rather than fall back to a per-call signature. A booking action may return actionRequired 'deposit_required' plus a deposit object (amount, currency, checkoutUrl); fund the deposit at checkoutUrl before treating the booking as settled.

Quote an offramp/payout from the platform rails (RAAST, Stripe, Solana). Returns estimated fees, execution window, and the rail to use. Feeds the hospitality payout flow. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Check the status and verdict of an adjudication case. Returns status (pending/auto_executed/escalated), verdict, confidence, and reasoning.

Resolve a business profile by id (public). Returns the sanitized public view (name, category, address, rating, trustScore, phone, email, coverImageUrl). Owner PII is gated — use pabandi:verify_owner for full PII. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Look up a passport issuance charge by idempotencyKey (public audit). Returns feePab, ownerUserId, agentId, riskBand, capabilities, chargedAt. Example: {"idempotencyKey": "iss-3001"}

Query the lifecycle status, rail settlement confirmation, and ledger journal of an orchestrated payment by ID.

Get the verified service catalogue, pricing, deposit requirements, and Pabandi Trust Score for a business (by ID or slug). Use this before booking to inspect services and merchant reliability.

Register an agent's identity onchain via ERC-8004. Creates a portable onchain identity that can be verified across the ecosystem. Returns the onchain agentId and transaction hash. Gasless for the agent (Pabandi pays gas).

Sync an agent's trust score to the onchain ERC-8004 reputation registry. Posts feedback about completed tasks and success rate. Gasless for the agent (Pabandi pays gas).

Issue a scoped Agent Capability Passport (auth required via Bearer token from the owner). Capabilities validated against trust band. Metered at PAB_FEE_PER_PASSPORT $PAB per issue; idempotent via idempotencyKey. Example: {"agentId": "svc-agent-7", "capabilities": ["act:book", "read"], "idempotencyKey": "iss-3001"}. Get API key at POST /api/v1/agents/register.

Return a business's connected open-finance connections (verified + pending). Used by third parties to confirm a business has a real payout path before booking or partnering. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

List all active payment rails with live fee comparisons, average settlement speed, supported currencies, and Sharia compliance status.

Query properties, rental units, stay experiences, and leases available in Pabandi PropertyOS. Returns address, monthly/daily rate, bedrooms, bathrooms, and availability for AI agent bookings.

Post a machine-to-machine project to the marketplace. Creates an open project with escrow protection. Returns projectId and hireUrl. Used by agents to post work they need done.

Open a Trust-Score-derived PabandiSession tab so the agent or user can transact repeatedly via pabandi_execute_transaction without per-call wallet signatures.

Check whether the caller can access a given Pabandi platform tool (by MCP tool name). Returns ok + note.

Return the Pabandi Platform discovery doc: every tool on the platform, the OpenAPI/spec URL, the PTP verification endpoint, the public key, and the SDK access info. This is the entry point any third-party app, LLM, or agent uses to learn what Pabandi can do and how to call it. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Forward-predict the no-show and completion probability for a PROSPECTIVE booking (before it is created). Blends real customer + business history (Beta-binomial shrinkage), lead-time, and day-of-week. Returns predictedNoShow, predictedCompletion, confidence, and the top factors. This is the predictive intelligence the trust rail uses. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Return 24 hourly demand buckets for a business (from completed reservation history). Used to surface busy windows and optimize pricing/staffing. Owner-gated. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Recommend the best upcoming slots for a guest at a business: each candidate scored by predictedCompletion, lightly load-balanced away from peak hours. Returns top 3 slots with predicted completion + demand. Owner-gated. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Lock funds in escrow using an ERC-7710 delegated budget. Requires delegationId (from a prior grant) and amount. Verifies MaxAmount, Expiry, and AllowedContracts caveats before locking. Returns escrowId and remaining delegation budget.

Get an agent's scheduling priority based on trust score. Returns tier, session limits, recommended actions, and match priority weight. Higher trust = better job matches and higher session limits.

Search verified businesses and services by name, category, city, or location. Every listing is tied to a Pabandi Passport trust score. Uses Postgres contains + OpenStreetMap Nominatim (no paid geo API). Returns real, deduped results — never empty. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Close an open session and optionally settle remaining funds. Returns settlement summary.

List all sessions opened by an owner (user or agent). Returns sessions with balances and status.

List all receipts (spend records) for a session. Returns the full spend history.

Simulate dynamic routing across the 4-layer payment stack to evaluate cost, speed, failover cascade, and savings against conventional processors.

Initialize a milestone-based or native SOL/BSC escrow for a booking: business deposits, guest/host holds collateral, release on completion. This is the real-chain escrow rail (Solana + BSC Hardhat contracts). GATED to exclusive platform access — real chain writes require verified ownership + settlement rail. [exclusive] Exclusive: real-chain escrow writes are gated behind a verified PTP trust band (A/B) or an exclusive platform grant, so only trusted counterparties open real money on chain. Verified-only stays use the simulated escrow path. This is the premium moat — the real rail, gated. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Submit an EvidenceBundle to open an Internet Court adjudication case. Requires jobId, buyerClaim, sellerProof (IPFS/content hash), and optional oracleData. Returns the case id and status.

Resolve the trust score and reputation for a passport/agent. Returns trustScore, tier, verifiedIdentity, and capability band. Used by agents to evaluate counterparties before transacting.

Verify a Year-0 Ed25519 SignedTrustAttestation score receipt (modelHash, inputFeatureHash, predictedScore, trustBand, shapVectorHash, nonce, timestamp, signature). Confirms score and SHAP attribution integrity in under 1 ms.

Verify a human trust passport and get their trust score, tier, and verification status. Use this before booking or transacting with any human counterparty to assess reliability. Price: $0.01 USDC.

Verify a Pabandi PTP attestation (agent/business/individual/trust rail). Input base64-encoded attestation token and optional need (e.g. "act:book"). Returns valid, grantedCapabilities, riskBand, expiresAt. Works offline. Example: {"token": "...base64...", "need": "act:book"}

Verify a W3C VC / IETF SD-JWT selective-disclosure trust presentation (<issuer-jwt>~<disclosure_1>~<disclosure_2>~). Returns verified disclosed claims (trust_band, deposit_basis_points, zero_deposit_eligible) without exposing raw PII or exact score. Free public verification tool.

Verify a Pabandi PTP attestation (business, individual, agent, or trust rail). Re-executes the HMAC-SHA512 signature over a fixed subset of fields and returns valid + the verified claims. Offline-verifiable: any party can check a signed attestation without calling Pabandi. This is the trust primitive every third-party action gates on. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.

Generate a zero-knowledge proof that an escrow split (deposit = price - commission, fee = deposit*rate, binding commitment to the valuation) is valid, WITHOUT revealing the private price/valuation/secret. Packs into a PTP attestation so the proof is verifiable offline by any third party. Real Noir circuit (compiled at startup); constraint-execution proof when no SNARK prover is available; upgrades to a succinct signature when the Barretenberg pipeline lands. [owner] Proves the escrow split is correct without revealing the valuation — the privacy + verifiability moat for real-estate/hospitality deals. Upgrades to a succinct on-chain-verifiable SNARK when Barretenberg is in the pipeline. This MCP tool makes a real HTTP call to the canonical Pabandi endpoint and returns the actual platform response.